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PREFACE 


This manual describes some of the considerations involved in planning and 
building an online application using GC0S/BES2 software. Unless stated other¬ 
wise, the term BES refers to GC0S/BES2 software; the term Level 6 indicates the 
specific models of Series 60 (Level 6) hardware on which the described software 
executes. GC0S/BES2 software executes on the 6/30 Models of Series 60 (Level 6). 

Section 1 presents the general characteristics of the various categories of 
BES software, and their roles in the development of an online application. 

Section 2 provides details of the capabilities of BES software, presents 
formulas for calculating the sizes of various data structures, and introduces 
such concepts as priority levels and logical resource numbers that provide both 
flexibility and efficiency in the completed application. 

Section 3 describes the use of the Configuration Load Manager. It includes 
a summary chart of the building process from the beginning stage where file 
space is allocated, through program development, to configuration and execution 
of the online application. 

Section 4 provides practical advice on debugging an online application. 

Appendix A contains complete descriptions of the CLM commands and their 
operands. 

Appendix B discusses the use of Executive object modules in building an 
online application. 

Appendix C presents examples of application configuration. 
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SECTION 1 


INTRODUCTION 


This manual shows you how to combine BES software modules with your own 
programs to achieve the functionality you require in your online application. 

The software has a number of features that enable you to concentrate on 
the solutions to your specific application problems, rather than to spend time 
developing, coding, and testing your own standard service routines. 

For example, Executive modules provide routines for task and clock manage¬ 
ment, and for the control of operator dialog with the software. Also included 
are routines for time and date recording, as well as trap and error handling. 
There is a set of routines that allows you to execute your application as a 
series of overlays — the Overlay Loader provides the basic capabilities for 
loading and starting overlay code. 


The input/output modules provide file management facilities, and reentrant 
routines for driving all available devices. Moreover, the software includes 
Communications modules that function through the standard physical I/O inter¬ 
face, and can be configured and used as easily as any other peripheral device. 

Furthermore, the modularity of the software allows you to choose only thos 
services that you require. For example, you may or may not want to include the 
Executive buffer management capability as an integral part of your configured 
application. 

Since the software is supplied in load module form, you do not have to 
assemble and link the various routines that you want to include in your applica 
tion. As soon as you have finished developing your programs so that they are 
executable load modules, you are ready to configure your application. 

The process chart in Section 3 gives you an overview of the operations 
involved in building your application. You will be using various functional 
groups of software modules in the building process. For example, in setting 
up your application environment, you will use the utility programs to prepare 
and maintain disk volumes. See the Utility Programs manual for details. 
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You will use components described in the Program Development Tools manual 
to prepare your own application programs. 

To make a realistic debugging environment for online application programs, 
the software provides an Online Debug Program that operates under the Executive. 

When your own load modules are ready for use, you configure your online ap¬ 
plication by using a software component called the Configuration Load Manager 
(CLM). The CLM, working in conjunction with a loader, provides a load-and-go 
capability for your application. For smaller systems, CLM can be executed as 
a series of overlays. 

CLM accepts command input in which you have specified the various character¬ 
istics of your application, such as memory size, numbers and types of devices, 
and the load modules, both BES modules and your own, to be included in the final 
configuration. CLM uses this command information to build the data structures 
and to load the necessary modules that the Executive software uses to control 
processing. A special facility permits user-written application initialization 
during loading. 

After all the specified modules are loaded, CLM turns control over to the 
highest priority task that has been designated as initially active, and applica¬ 
tion execution begins. 
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SECTION 2 
PLANNING 


Planning an online application includes the process of systems analysis and 
design, taking the fullest advantage of the system services and development tools 
supplied by Honeywell. This process includes: 

• Acquiring a familiarity with the capabilities of BES software 

• Defining application design objectives 

• Defining online environment characteristics 

• Designing programs to be run in an online environment 

OVERVIEW OF BES SOFTWARE SERVICES 

BES provides a number of services that you should consider when planning an 
online application. There are also a variety of tools for use in the develop¬ 
ment of application programs. These software modules are summarized in 
Tables 2-1 and 2-2 below. 

Services Available for Application Execution 

The BES-provided services for use during online application execution are 
summarized in Table 2-1, and described in detail in the Executive and Input/ 
Output manual or the FORTRAN manual, as appropriate. 

Services Available for Application Development 

The BES-provided tools for use during application development are sum¬ 
marized in Table 2-2, and described in detail in the Program Development Tools 
and Utility Programs manuals, as appropriate. 

In addition to the services summarized in Table 2-1, BES provides a 
Configuration Load Manager (CLM) which defines the context of the application, 
sets up the required internal data structures, loads the specified modules, and 
initiates execution of the application, all in one continuous operation. The 

operation of the CLM and the syntax of its commands are described in this 

\ 

manual. 


2-1 


AU4 9 



Table 2-1. BES Software for Application Execution 


Service 

Description 

Task Manager 

Monitors and controls all tasks in the applica¬ 
tion, using data structures defined during 
configuration. The Task Manager oversees the 
level activity indicators, administers the inter¬ 
rupt structure, and coordinates requests for the 
execution of tasks. 

Clock Manager 

Activates priority levels after an elapsed time 
interval or at regular time intervals, as speci¬ 
fied during configuration. An expanded Clock 
Manager is available, providing date and time 
information in ASCII format for external 
reporting. 

Operator Interface Manager 

Controls all operator dialog with the software 
through a KSR-like device. 

Buffer Manager 

Coordinates requests for buffer space, using 
control structures and buffer pools defined during 
configuration. Use of the Buffer Manager is 
optional but recommended. 

File Manager 

Opens, reads, positions, writes, and closes files; 
reports file status information and error condi¬ 
tions. Use of the File Manager is required for 
FORTRAN and COBOL programs. 

Overlay Loader 

Controls the loading of planned overlays through 
data structures created by CLM. 

Communications Supervisor 

Provides necessary services to communications 
handlers including time-out, request validation, 
and Task Manager interface. 

Device Drivers 
(Disk, Printer, Card 

Reader, KSR/ASR, VIP, BSC, 
TTY, MLCP) 

Perform all data transfers between the online 
application and its respective devices. Drivers 
receive requests for service from the Task 

Manager and run at the priority level of the 
requested device. 

Floating-Point Simulator 

Provides double-precision arithmetic and a 
scientific instruction set. Operates as a trap 
handler under the Executive. 

Scientific Branch 

Simulator 

Operates as a trap handler under the Executive to 
provide FORTRAN and assembly language programs 
with the means to simulate the use of scientific 
branch instructions. 

Trace Trap Handler 

Traces the contents of a specified memory loca¬ 
tion and maintains a limited trace history. 

FORTRAN Run-Time I/O 
Routines (FRIOR) 

Provides for reading and writing of formatted and 
unformatted records; edits integer, real, logical, 
and character data for formatted input and output, 
and produces diagnostic messages for inappropriate 
commands. These routines require the use of the 
File Manager. 

Online Debug Program 

Provides online program testing and patching 
facilities for application programs running under 
a BES Executive. 

COBOL Run-Time Routines 

Supports the COBOL procedural statements that 
involve arithmetic, logical, data manipulation, 

and input/output operations. 

. _ . ... . 
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Table 2-2. BES Software for Application Development 


Component 

Function 

Utility Programs 

File maintenance and handling, media transfers, 
printing, debugging. 

Editor 

Creates and/or corrects source programs on disk. 

Macro Preprocessor 

Provides for definition and expansion of macro 
routines. Macro Preprocessor output is input to 
the Assembler. 

Assembler 

Produces object modules from source programs 
written in BES assembly language. 

COBOL Compiler 

Produces object programs from source programs 
written in COBOL. 

FORTRAN Compiler 

Produces object modules from source programs 
written in FORTRAN. 

Linker 

Produces load modules from object text output of 
all language processors. 


DEFINING APPLICATION DESIGN OBJECTIVES 

The careful description of the specific design objectives of your applica¬ 
tion is an important part of the overall planning process. You should have a 
precise inventory of the numbers and kinds of problems that your application 
programs will be designed to solve, the files required, and the types of reports 
to be generated. 

This inventory will greatly simplify your assessment of the physical and 
logical resources required to achieve your design objectives. Your inventory 
should contain information about the source language in which your particular 
application program is written because high-level languages such as COBOL and 
FORTRAN require the File Manager to handle the logical input/output operations 
between programs and the physical devices that contain the data read and written 
by those programs. Table 2-3 shows one way of relating a design objective to 
the physical and logical resources needed to implement that objective. 

Table 2-3. Physical and Logical Resource Requirements 


Design Objective 

Application Program 
Source Language 

Resources Needed 

Logical 

Physical 

Produce a report 
based on daily 
card input 

COBOL 

Input task 

Processing task 

Output task 

File Manager 

Card Reader 

Disk device 

Line printer 
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There are other considerations about the use of logical and physical 
resources that are discussed throughout the remainder of this section. For 
example, the implications of providing certain values in the CLM commands, and 
the use of overlays to conserve memory space. There is a description under 
"Designing Programs for an Online Environment," later in this section, about the 
use of logical resource numbers to coordinate the use of interrupt priority 
levels by tasks and devices. 

DEFINING ONLINE ENVIRONMENT CHARACTERISTICS 

The characteristics of the online environment such as priority level usage, 
trap handling routines, time and date functions, as well as the complement of 
Executive software and file and buffer specifications, are chosen by supplying 
information to the CLM in configuration commands. These commands are described 
in detail in Appendix A; some of their more salient features are presented in 
this section. 

Selecting System Variables 

The information provided in the various commands to the CLM affects the 
numbers and sizes of control structures used by the Executive software to monitor 
processing. Choice of Executive services (and hence the Executive modules) has 
a direct bearing on the amount of available memory remaining for the loading of 
application programs. Table 2-4 summarizes the relationships between parameter 
values of the CLM commands and effects of these values on the sizes of control 
structures and memory usage. (See also "Size Calculations for System Data 
Structures," below.) 

Information for System Data Structures From CLM Commands 

Note that the CLM control commands direct the action of the CLM itself; the 
load configuration commands provide information to the loader that pertains to 
the loading order of the modules, and the identification of references among 
them. 


The system configuration, task, buffer management, and file management 
commands contribute information for the control structures that are used to 
regulate processing in an online application, in addition to providing CLM with 
data needed to calculate the sizes of these control structures. 
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Table 2-4. 


Effects of CLM Parameters on Memory Usage 






Default 





Default 

Value 

Structures 

Parameter 

CLM Command 

Range of Values 

Value 

(Words) 

Affected 

hilrn 


up to 255 

15 

16 

LRT size 

lolevel 

SYS 

6<value< 62 

15 

270 

Number of ISA's 

himem 


up to 64K 

Loader 

Address 


- 

lrn 

OIM 

Chilrn 

- 

- 

LRT and ISA 

level 


5<value<lolevel 

- 



number of 

TSA 

2<value<46 

2 


Number of trap 

TSA' s 





save areas 

size 


8<value 

8 

16 

Size of trap 






save areas 

trap number 

TRAP 

1 through 46 



See Table 2-5 

handler name 


ASCII name 



for sizes 

module name 

ADMOD 

- 

- 


See Table 2-5 
for sizes 

maxlfn 


<_2 55 

15 

32 

IORB 





224 

FDB 

concurrent 




56 

FCB 

calls 

FILMGR 

>0 

4 

272 

REB 

concurrent 




328 

Diskette buffer 

opens 


>0 

8 

392 

Cartridge disk 
buffer 

size, number 

BUFSPACE 

- 

- 


Size of PPT 

lrn 

TASK, ATLRN, 

<hilrn 



Number and size 

level 

DEVICE, TTY, 
VIP, BSC 

5<value<lolevel 



of RCT's 


The effect of some of the parameters in Table 2-4 on the amount of memory 
space used is small, so that if a default value is taken even when it is higher 
than that needed for a particular parameter, not much memory space is wasted. 
However, you should be careful about assigning higher than necessary values to 
the parameters for the file management commands, particularly the FILMGR com¬ 
mand. As you can see by inspecting the size calculation formulas that use 
information from this command, a careless assignment of values to the "concur¬ 
rent calls" and "concurrent opens" parameters will result in the reservation of 
much more space than needed. 

Moreover, the lolevel parameter value should be selected with care. The 
interrupt save areas (ISA) are set aside on the basis of this parameter, so that 
if you supply a value of 30, and actually only use 10 priority levels, 360 words 
remain unused. 
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SIZE CALCULATIONS FOR SYSTEM DATA STRUCTURES 


The system and task commands provide information for the calculation or the 
definition of the sizes of the following data structures: 

LRT - Logical resource table 

ISA - Interrupt save areas 

SOQ - Start of queue header table 

EOQ - End of queue header table 

TSA - Trap save area 

RCT - Resource control table 

The following formulas are used to calculate the sizes of these areas. 

S LRT = {hilrn + 1) 

If the default value is taken for hilrn, the size of this table would be 16 
words. 


S = MIN + (lolevel + 1-4) * MAX 

X Dn 

Where MIN = 6 and MAX =22. If the default value of 15 is taken for lolevel, 
the ISA would be 270 words long. 


S SOQ = S EOQ = (loleVel + D 

Using the default value for lolevel, each of these tables would be 16 words long. 


S = (number of blocks) * (blocksize) 

1 On 

Using the default values for these parameters results in a trap save area 16 
words long. 


A resource control table for a device is 16 words long; an RCT for a task 
is one word long. 

In summary, the size of the area devoted to those data structures defined 
by the system and task commands is: 


where N Q is 


S S LRT + S ISA + S S0Q + S EOQ 
the number of DEVICE commands, 


+ S TSA + N 


and S 


RCT 


* c -I- c 

D DEV RCT 

is the sum of RCT sizes. 


The buffer and file management commands provide information for the defini¬ 
tion of the following data structures: 

• PPT (pool parameter table) 

• Buffer area 

• Work area for File Manager 
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• IORB (input/output request block) 

• Diskette buffers 

• FDB (file descriptor block) 

• FCB (file control block) 

• Remote extent block 

• Device buffers 

• Wait table 

• Semaphore table 

• VDB (volume descriptor block) 

• LFT (logical file table) 

• FCB (device) 

9 FDB (device) 

The following formulas are used to calculate the sizes of these structures. 
S ppT = 4 words + (2*P) 

where P is the number of size/number pairs indicated in the BUFSPACE command. 


S 

buffer area 
S work area 
S IORB 

S diskette buffer 

S FDB 

S FCB 

S REB 

o 

device buffer 
c 

wait table 
S ST 

S VDB 

S LFT 

S FCB (device) 


(size^ * number^) + ... (size n * number^) 

(number of concurrent calls) * 40 
(number concurrent calls) * 8 

(number concurrent calls) *72+64 for cartridge 
disk 

(number concurrent opens) * 28 
(number concurrent opens) * 7 
(2 * number concurrent opens) * 17 
(number double buffers) * 77 
lolevel + 1 

16 + (2 * (number VDB + number FDB, . )) + 

device 

maxlfn + 2 + (2 * number concurrent 
opens) 

(number FMDISK commands) * 48 
1 + maximum Ifn + 1 

(number ATFILE commands) * (6+l+N/ 2 ) 


where N is the pathname length, space-filled to the next highest even number of 
bytes. 


S FDB (device) = ( number DEVFILE commands) * 28 
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Selecting Executive Modules 

BES software provides an Executive (ZXEX03) as a load module. This Execu¬ 
tive supplies capabilities for task and clock management, input/output handling, 
overlay loading, initialization processing, operator interaction with the soft¬ 
ware, time and date recording, trace trap and system error handling. Applica¬ 
tions that use the File Manager require this Executive. 

To complement the facilities provided by the Executive, you can also include 
either the File Manager or the Buffer Manager, or both of these load modules in 
your application. All FORTRAN applications require the File Manager. 

You may find that the load module version of the Executive does not exactly 
fit your application specifications. In that case, you can hand tailor an 
Executive load module from Honeywell-supplied object modules. See Appendix B 
for a description of this process. 

Selecting Input/Output Modules 

Input and output operations in your online application are handled by soft¬ 
ware modules called device drivers. You may select appropriate device drivers 
(or line-type processors for Communications devices) from the set provided by 
Honeywell (in either load or object module form), or you may write your own 
device drivers. See the Executive and Input/Output manual for details of this 
process. 

Table 2-5 contains the names and sizes of the Honeywell-supplied load 
modules. 

Selecting File and Buffer Management Techniques 

If your online application is programmed in assembly language, application 
requirements determine whether the File Manager is required (both FORTRAN and 
COBOL programs require the File Manager) for input and output operations. 

When your application needs only minimal I/O functions, you can gain a 
space advantage by using the device driver alone and save the 3200 words 
occupied by the File Manager. However, you then must program whatever I/O func¬ 
tions your application does need. The advantage of using the File Manager is 
that it provides these needed functions, and hence, I/O processing with the 
programming simplicity of a higher level language. 

The following discussion illustrates the advantage of using the File 
Manager over a device driver alone when the I/O device is a disk. 
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Table 2-5. 


Names and Sizes of Honeywell-Supplied Load Modules 


Load Module 
Name 

Description 

Approximate 
Size in Words 
(Decimal) 

ZXEX03 

Executive 

2600 

ZXBM01 

Buffer Manager 

100 

ZYFM02 

File Manager 

3200 

ZIDSK 

Diskette Driver 

175 

ZICDSK 

Cartridge Disk Driver 

225 

ZIKSR 

Keyboard-Send-Receive Driver 

450 

ZIASR 

Automatic-Send-Receive Driver 

1200 

ZICDR 

Card Reader Driver 

125 

ZILPT 

Printer Driver 

125 

ZXOVLY 

Overlay Loader 

275 

ZDBG 

Online Debug Program (overlay 
version) 

1200 

ZQEXEC 

Communications Supervisor 

580 

ZQMLON 

MLCP Driver 

500 

ZQPTTY 

TTY Line-Type Processor 

980 

ZQPVIP 

VIP 7700 Line-Type Processor 

1270 

ZQPBSC 

BSC 2780 Line-Type Processor 

1200 

ZFPSIM 

Floating-Point Simulator 

400 

ZFBSIM 

Scientific Branch Simulator 

250 

TRPHND 

Trace Trap Handler 

150 

NOTE: The names of the object module versions are 

listed in Appendix B. 


When using a device driver alone to perform input/output operations, the 
application program must build its own data structures to interface with the 
driver, and initialize those structures with the data that the driver needs in 
order to locate the required data on the device. This information consists of 
the initial sector to be transferred given by the sector number relative to the 
beginning of the volume, and the number of bytes to be transferred. 

After the I/O request is made, the driver will transfer the requested 
number of bytes starting at the boundary of the sector specified. The implica¬ 
tion of dealing with sectors it twofold: the application program must know, for 
each set of data (logical record) the number of the sector in which the record 
resides. Secondly, if there is more than one logical record per sector, the 
program must do its own deblocking; i.e., must find the logical record it needs. 

By contrast, the File Manager builds the I/O data structure for the program 
and provides the initializing information by which the logical record is 
retrieved when provided with a record number relative to the beginning of the 
file. 
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On a read operation, the File Manager transfers the requested data record, 
not the physical sector, into the program's buffer area, and the program then 
does not have to search for and deblock the records itself. 

To summarize, the File Manager works at the program's logical level with 
files and records; a driver works at the hardware physical level with sectors. 
When using nondisk sequential devices, the File Manager provides some measure of 
device independence at the application interface. 


FILE MANAGER BUFFER HANDLING 

The File Manager allows nondisk devices to be buffered. When you configure 
your application, you can request the File Manager to reserve internal space for 
a data buffer for a particular LFN (see the DEVFILE command in Appendix A). The 
purpose of this buffering is to allow application code to execute in parallel 
with I/O transfers. 

File Manager achieves parallel processing in two different ways, depending 
on whether the LFN is used for obtaining data from a device (reading), or 
transferring data to a device (writing).'*' 

Buffered Read Operations 

A buffered read results in an anticipatory read in addition to every read 
command issued by the application. When the LFN represents a card reader, this 
means that a second card will be read immediately after the application reads 
(and waits for the data to arrive in its buffer) the first card after the LFN is 
opened. The application can now process the data it has while the physical I/O 
transfer for the next card into the File Manager's buffer is in progress. 

Nondisk file types recognized by the File Manager may be classified as 
interactive or noninteractive. Interactive device names are: KSR, KSI, KSO, 
ASR, ASI, ASO, VIP, VIPI, VIPO, TTY, TTYI, TTYO (see DEVFILE command in 
Appendix A). 

Buffered interactive and noninteractive file types operate exactly the same 
after they are opened. A noninteractive file, when opened, does not initiate an 
anticipatory read by the File Manager. This means that the application must 
wait for the physical I/O transfer to occur on the first read; thereafter the 
parallel operation described above, occurs. 


1 


Bidirectional LFN's cannot be buffered. 
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An OPEN command to an interactive file type does cause an anticipatory read 
into the File Manager's buffer to occur. If the application program immediately 
followed the OPEN with a READ command, the effect is exactly the same as for a 
noninteractive file type; i.e., the application is suspended until the read 
operation into the File Manager's buffer completes and data is moved into the 
application program's buffer. However, the application program can avoid 
suspension on the first or subsequent READ commands by using the Status Read 
command, which gives the program immediate information as to whether the File 
Manager's buffer now contains the next record. If not, the application program 
can continue processing and only perform the read operation when the result of 
the Status Read indicates that data is available. 

The primary use for buffering an interactive file type is to allow an 
application to control input from more than one LFN, each of which represents a 
console at which operators enter data. The application program cannot perform a 
READ on any particular LFN, and wait until data arrives because the operator at 
that terminal may not be present, and the application program is then indefi¬ 
nitely suspended. To avoid this indefinite suspension, the Status Read should 
be used, in this way the application program will never perform a READ unless 
data is present. (It is because of the indefinite response on an input LFN that 
the OPEN command to an interactive file type causes the anticipatory read, thus 
the Status Read is meaningful for all read operations, not only for the first 
one.) 

Buffered Write Operations 

A buffered write operation to an LFN works on behalf of the application 
program in the same logical manner as the read — the program is permitted to 
execute in parallel with the physical I/O transfer to the device. To achieve 
this parallel processing, no special operation occurs on an OPEN command, and no 
distinction is made between interactive and noninteractive file types. Each 
write command is completed by moving data from the application buffer to the 
internal File Manager's buffer, initiating the transfer, and returning control 
to the application program. If the program performs a second write operation 
while the internal buffer is still in use for a previous transfer, the applica¬ 
tion is suspended until the buffer is available and new data moved into it 
again. The application can avoid suspension by using the Status Write command 
to see if the internal buffer is still in use or not. 

Special considerations for buffered write operations arise because, if a 
physical I/O error occurs while data is being transferred from the internal 
buffer to the device, the application program is unaware that an error has 
occurred unless it checks the file status after each write. Furthermore, if an 
error does occur, the application program may need to have saved (or be able to 
retrieve) the data record so that it can be repeated. 
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To summarize, a Status Write should be used to test for buffer availability 
and no error status before each write operation (not required on the first write 
operation) or the close operation of the file. 

INTERACTIVE FILE TYPE/LFN COORDINATION 

Using the File Manager to provide application programs (including those 
written in FORTRAN or COBOL) with read and write capabilities for KSR-like 
devices requires two LFN's, used as a pair. Both LFN's represent the same 
physical device, one for the keyboard input, and the other for the printer 
output. Two LFN's are required because the read LFN must be buffered if more 
than one terminal is being controlled, and a bidirectional, buffered file type 
is not supported by the File Manager. 

Whenever both LFN's are buffered or not depends on the application's needs. 
However, when the terminal being controlled is physically attached to a communi¬ 
cations controller (MLCP), great care must be taken to coordinate the closing of 
the files involved. If one is closed before the other is finished using the 
terminal, the other LFN will be unable to access the device because the close 
operation causes the connection to be broken. (A media error is returned to the 
application.) For further information, see the discussion of CONNECT (used by 
the File Manager OPEN function), and DISCONNECT (used by the File Manager CLOSE 
function) in the Executive and Input/Output manual. 

PRINTER SPACE CONVENTIONS 

In planning an application that uses line printers and terminals (consoles) 
interchangeably, you must consider the differences in format conventions between 
these two types of devices. 

The line printer driver (and the IORB within the File Manager for the LPT 
device-file) assume that a space-before-print convention is appropriate. The 
device-specific word and the format control byte allow convenient prespacing. 

The teleprinter driver allows prespacing but also supports post-line feed 
operations usually associated with console-oriented print-then-space conven¬ 
tions. This convention is designed to allow input to begin on a new line with¬ 
out doing a line feed after a key is struck. 

The File Manager's preconfigured IORB associated with any KSR-like device 
assumes a post-line feed is desirable. 

The application can accommodate either convention, by itself, without 
difficulty, but if the devices are interchangeable, care must be taken to avoid 
either: 

• Double spacing because the format byte specifies prespace one line, 
and the teleprinter IORB enforces a post-line feed 
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• Overprinting because the format byte specifies no prespace, and the 
line printer does not support post-line feed 

The distinction as to device type is made, using the File Manager, by 
interrogation of file type status* Physical I/O can discover the difference by 
locating the RCT for the particular LRN and testing the device ID. 

DESIGNING PROGRAMS FOR AN ONLINE ENVIRONMENT 

As you design your application programs, remember that they will be using 
some of the same system resources that are used by the Executive software. For 
this reason, your application programs should conform to certain conventions 
that make the joint usage of these resources as efficient and error-free as 
possible. These conventions concern the use of interrupt priority levels, the 
definition of control structures, the use and saving of registers, as well as 
the standard ways of defining, identifying, and calling the various Executive 
and application modules. 

Multitasking 

The following paragraphs describe what has to be done to set up your 
application for multitasking execution. Appendix C contains a sample program 
that illustrates configuration, linking, task control blocks, and tasking. 

A task is a sequence of executable code whose execution is initiated and 
terminated by calling task management functions described in the Executive 
manual. When several tasks can be active simultaneously you have multitasking. 
The criterion used by firmware to select a task for execution, from among those 
have been initiated and are active, is_ the task's priority level; the task asso¬ 
ciated with the highest priority level is the one to be scheduled next. 

PRIORITY LEVELS 

Each task and device (i.e., the device driver task) is associated with a 
priority level number, reflecting its relative processing priority in an appli¬ 
cation. In this priority scheme, the lower the level number the higher the 
priority. Table 2-6 contains a list of possible relative priorities for tasks. 
Level 0 through 4 (the five highest priority levels) and level 63 (the lowest 
level) are reserved for system use and do not need to be specified during 
configuration. All other levels are available for use by application program 
tasks and devices. 

Table 2-6 includes all the devices that currently are supported on Level 6 
hardware. If fewer devices are used, fewer levels are needed while maintaining 
the relative position of the levels. It is suggested that consecutive levels be 
used, without skipping a level number , to save data structure space that would 
otherwise be reserved for the unused levels. 
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Table 2-6. Relative Priority Level Assignments 


Level 

Use 

0 

Power failure handler 

1 

Watchdog timer runout 

2 

Trap save area overflow 

3 

Inhibit interrupts 

4 

System clock 


Communications interrupt 


Communications Devices (less than or equal to 9600 bps) 


Cartridge disks 


Communications Devices (less than or equal to 1200 bps) 


Diskettes 


Printers 


Card readers 


ASR/KSR 


Online Debug Program 


Operator Interface Manager interrupt 


Input/output - bound application tasks 


Central processor - bound application tasks 

63 

System idle loop (always active) 


The table indicates I/O devices, and not device drivers, to stress that 
each (noncommunications) peripheral device must have at least one level assigned 
to it; peripherals cannot share a level. If there are two printers, each must 
be assigned a unique level. Actually, when a device level is initiated, it is 
a reentrant I/O driver that is initiated of which only one copy need be in 
memory. 

Communications requires one nonshareable level dedicated to processing com¬ 
munications interrupts, and it must be at a higher level than any communications 
devices. Communications devices can share a level. For example, four TTY's and 
one VIP can either share one level or be configured to use up to four levels. 

The listed priority arrangement is designed to provide maximum throughput 
for each device by assigning the high transfer rate devices a higher priority 
than the lower transfer rate devices. I/O-bound tasks are run at a higher 
priority than central processor-bound tasks since this enables I/O-bound tasks, 
which run in short bursts, to issue I/O data transfer orders as needed, wait for 
I/O completion, and while in the wait state, relinquish control of the central 
processor to the central processor-bound tasks. Otherwise, if the central 
processor-bound tasks had a higher priority, the I/O devices would be idle while 
I/O-bound tasks wait to receive central processor time. The criteria used to 
specify Table 2-6 might not suit a particular application and the level assign¬ 
ments should be modified to include other priority considerations. 
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LOGICAL RESOURCE NUMBERS 


To enable an application program to be independent of level numbers, the 
software provides logical resource numbers (LRN's) to associate application 
tasks and devices with priority levels. 

An LRN (and not level number) is given with each task request to indicate 
the level at which the task is to execute. The level at which the task executes 
is determined finally by the level that was attached to the LRN at configuration 
time. If level changes are to be made, the application only has to be recon¬ 
figured with the new level; the program does not have to be changed. 

Although an LRN is attached to a unique level, more than one LRN can be 
attached to the same level when LRN's are used synonymously (e.g., two 
independently created tasks refer to the same task by different LRN's), or when 
tasks or communications devices share the same level. 

Figure 2-1 illustrates an association between tasks of an application and 
priority levels. The first column describes the task to be initiated. During 
task initiation the task is associated with one of the LRN's in the second 
column which was attached, at configuration time, to one of the priority levels 
listed in the third column. The level assignments follow the priority scheme 
listed in Table 2-6. 
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Starting with the tasks at the top of the figure, the operator's console by 
convention uses LRN 0. Following it are two communications device drivers, each 
with a separate LRN and sharing one level with LRN 6. VIP 2 has different LRN's 
for input and output, but it must have the same level. This allows a different 
configuration to use different devices without changing the program. Further 
down, two diskettes have unique level assignments, since peripheral devices 
cannot share a level. Level 9 is unused . Application tasks can share a level, 
and tasks 2 and 3 share level 15. Task 1 can be initiated by using LRN 10 or 
LRN 13, both referring to level 14. Although it might appear otherwise, the 
order of the task-LRN association is almost arbitrary. Levels 0 through 4 are 
dedicated assignments that do not require CLM statements. Level 5 though not 
attached to a LRN must be specified using the CLM COMM command. 

ATTACHING LRN's TO LEVELS 

The CLM ATLRN command is used to attach one LRN to one level. The DEVICE 
command does the same for peripheral devices. Each communications device has a 
unique command. An example of the commands used to specify the relationship 
illustrated in Figure 2-1 is given in Figure 2-2. 


OIM 

0,13 


• 

COMM 

5 


Communication Interrupt Level 5 

DEVICE 

KSR,0,13 ,X 

0500' 

Operator's Console Level 13 

TTY 

1,8,X'FD80 


Remote TTY Level 8 

VIP 

2,8,X'FC00 


Remote VIP Level 8 

DEVICE 

FCD,3,6,X' 

L280' 

Cartridge disk (fixed) Level 6 

DEVICE 

RCD,14,6,X 

1280',3 

Cartridge disk (removable) Level 6 

VIP 

4,7,X'FC8 0 


Remote VIP input Level 7 

EQLRN 

5,7 


Remote VIP output Level 7 

TTY 

6,8,X'FD00 


Remote TTY Level 8 

DEVICE 

DSK,7,10 , X 

1300' 

Diskette Level 10 

DEVICE 

DSK,8,11 ,X 

1380' 

Diskette Level 11 

DEVICE 

LPT,9,12, X 

0580' 

Line printer Level 12 

ATLRN 

10,14 


Task 1 Level 14 

ATLRN 

11,15 


Task 2 Level 15 

EQLRN 

12,15 


Task 3 Level 15 

ATLRN 

13,14 


Task 4 Level 14 


Figure 2-2. Sample Statements Attaching LRN's to Levels 


The cartridge disk used in the example has a fixed and a removable disk, 
and needs two DEVICE commands. The parameter "3" is required to cross reference 
the previous disk DEVICE command LRN. 
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The EQLRN command is used when a new LRN has the same level as another LRN. 
For example: 


ATLRN 11,15 
EQLRN 12,15 

The ATLRN with an RCT-size parameter enables you to specify another RCT for a 
level. This feature could be used to create an RCT for a nonstandard device. 

The program would then have to initialize the RCT with data that the CLM normally 
enters from the CLM Command parameters; e.g., channel number, modem. 

None of the statements in Figure 2-2 will cause execution to start after 
loading. To start execution immediately after loading, the TASK command must be 
used with the fourth parameter set to YACT. If TEST01 (a task) with LRN 10 were 
to be activated after loading, the TASK command would be: 

TASK TEST01,10,14,YACT 


REQUESTING TASKS 

To have task A request task B for initiation, task A calls Task Manage¬ 
ment's "request" routine, and passes it the address of task control block (tcb) 
containing task B's start address and LRN. The tcb is built and initialized by 
the calling task, task A. If more than one task is to be initiated at the same 
priority level, the first task requested is the first one to be executed, with¬ 
out interruption from other tasks at the same level. The LRN used in the call 
to the "request" routine can be attached to a level during configuration either 
by using the ATLRN or TASK commands. However, if a task is to be executed 
immediately after loading, it must be def.. led in a TASK command. 

An alternate means for requesting a task can be used when the task is to 
have exclusive use of a level. Instead of obtaining a start address from the 
tcb. Task Management uses the B5-register contents of the interrupt save area 
(ISA) of the priority level of the requested task. A bit set in the tcb by the 
calling task indicates to the Task Manager whether to use a start address in the 
tcb or ISA. To initially set the B5-register to a desired task start address, 
the TASK command must be used. CLM takes the start address given in the command 
and places it in the B5-register of the ISA. 

If a task, after it terminates, is to be called again using the address in 
the ISA, the terminating task must contain a terminating code sequence that 
permits the B5-register in the ISA to be restored to the desired start address. 
Such a code sequence of a terminating task is given below. 


2-17 


AU49 



A LDV $ Rl, = 13 0 
A+l LNJ $B5,< ZXTERM 

A+2 (first instruction of task being terminated) 

The context of the level is saved in the ISA whenever a task terminates at a 
level. In the above terminating code sequence, the B5-register contains the 
address A+2, which is the desired start address of the task. 

Input and Output Drivers 

The input/output operations in your application are handled by software 
components called drivers (for conventional peripheral devices) or line-type 
processors (for communications devices). These components perform the following 
general functions: 

• Initiate I/O operations on individual devices 

• Report errors and status information 

• Monitor timing to detect device failure or inactivity 

• Perform limited editing of transferred information 

See the Executive and Input/Output manual for descriptions of the drivers and 
the control structures they use. 

Honeywell supplies device drivers in both load and object module form. The 
names and sizes of the driver load modules are given in Table 2-4. The procedure 
for linking object module device drivers is described in Appendix B of this 
manual. 

A Honeywell-supplied driver is implicitly loaded when CLM processes a 
DEVICE command. The DEVICE command provides the logical resource number and the 
priority level for the specified device. Similarly, the line-type processors 
are implicitly invoked when the appropriate communications device command (TTY, 
VIP, BSC) is processed. 

If you write your own device driver, implicit invocation does not occur, 
and in order to include the module in CLM's load list, you must include an 
explicit ADMOD command in the configuration command file that builds your appli¬ 
cation. Furthermore, if your device driver requires nonstandard commands and 
parameters, you must provide the interpretive routines that build the control 
structures required by your driver as extensions to the CLM. 1 

The Honeywell-supplied drivers and line-type processors are reentrant, so 
that only one copy of the driver appears in the final configuration. 


i 

'■'Consult the current Release Bulletin for details about CLM extensions. 
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Memory Usage Considerations 

The memory area used by an online application consists of hardware-dedicated 
locations, data structure areas, load module residence areas, buffer and loader 
areas, and areas occupied by the symbol table and the CLM on a transitional 
basis. The total size of these areas determines the memory size requirements of 
an application. 

NOTE: In the descriptions that follow, all memory locations are 

specified in hexadecimal notation, unless otherwise indicated. 

HARDWARE DEDICATED LOCATIONS 

Low memory, from location 0 through location OOBF, is reserved for BES use. 
Among the indicators and pointers stored in this area are the trap save area 
pointer (word 0010), clock information (words 0014, 0015, and 0016), the level 
activity indicators (words 0020 through 0023), the trap vectors (words 0052 
through 007F), and the interrupt vectors (words 0080 through OOBF). A detailed 
memory layout and explanation of contents of the hardware-dedicated locations 
appears in the Executive and Input/Output manual. 

DATA STRUCTURE AREAS 

Immediately above the hardware-dedicated locations is the data structure 
area. During the configuration process, the CLM builds the data structures 
required by the online application in this area of memory. Using the informa¬ 
tion supplied in its commands, the CLM determines the sizes of tables and save 
areas, constructs the framework of various tables, and inserts into those tables 
the information that is available at the time. The data structure area begins 
at location 00C0 and extends as far as necessary to accommodate the required 
structures. 

Figure 2-3 illustrates the layout and contents of memory. 

OVERLAY PLANNING 

The overlay technique allows you to economize on memory by using a given 
portion of it over and over again; it also forces you to think critically about 
the nature of the solutions to your application problems, and the order in 
which those solutions are achieved. 

The Overlay Loader consists of a set of reentrant service routines that 
provide the basic capabilities required for loading and starting overlay code. 
(See the Executive and Input/Output manual for details.) 

The Overlay Loader resides in memory during application execution; it con¬ 
trols overlay processing by using an overlay file and a set of data structures 
that were created by CLM as a result of information in the bound unit (root and 
overlay segments) produced by the Linker. 
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HIGH MEMORY 




- END OF LOADER 

HMA 

LOADER 

^ _ HIGH MEMORY ADDRESS <HMA 

HIMEM 




LOADER 



EXTENSIONS 


LOCX 


START OF LOADER EXTENSIONS 

LOCE 


END OF LAST LOAD MODULE + 1 


LOAD 



MODULES 


LOCS 


START OF FIRST LOAD MODULE 


SYSTEM 



DATA 



AREA 


00C9 


-POINTER (RESERVED) 

00C8 


-HIGH MEMORY ADDRESS (<HMA) FROM SYS COMMAND 

00C7 


—f-POINTER TO LAST LOAD MODULE +1 

00C6 

LOAD 

-hilrn FROM SYS COMMAND 

OOC5 

COMPLETION 

-POINTER TO WORD BEFORE CLOCK QUEUES (ZXCMGR) 

00C4 

DATA 

-POINTER TO START OF LRT 

00C3 


-HMA OF LOADER 

00C2 


-* -POINTER TO START OF QUEUE HEADER 

00C1 


-POINTER TO FIRST LOAD MODULE 

ooco 




DEDICATED 



LOCATION 


0000 




LOW MEMORY 


residue area 

= HIMEM - LOCE 



Figure 2-3. 


Memory Data Structures 
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Establishing Overlay Areas 

The items and locations used in the following discussion are shown in 
Figure 2-3. 

Theoretically, all of memory above the system data area (LOCS) should be 
available for use by programs that execute as overlays. There are some limita¬ 
tions, however. 

Apart from the fact that the root module of a bound unit must be resident 
during execution, thus limiting the actual area that can be used by the overlays, 
there is a property of overlay code produced by the higher level language 
compilers, and even some types of code written in assembly language that makes 
unrestricted use of all available memory impossible. Such code is called 
"nonfloatable." (Refer to Program Development Tools manual for details.) 

Normally, CLM treats all overlays as if they were nonfloatable; that is, it 
loads them into memory in exactly the area from which they will eventually be 
executed. The total area required for a set of nonfloatable overlays is the 
area required by the largest nonfloatable overlay module. The first example 
below shows a bound unit that has two nonfloatable overlays. 

If the overlay code is floatable, that is, dynamically relocatable when it 
is reloaded for execution, the overlay does not contribute to the overall load 
space, and it is possible to use the area above the end of the last load module 
(LOCE) in which to position the floatable overlays. This is particularly 
important when LOCE and LOCX are nearly the same value; then floatable overlays 
can be executed in the area reserved by CLM during loading. 

Perhaps the simplest way to set aside space for floatable overlays is to 
incorporate the Buffer Manager in your configuration and request blocks of 
memory equal to the size of overlay code in the BUFSPACE command to CLM. 

Alternatively, the CLM residue above LOCE can be used by developing 
specific addresses in the root after all loading is complete based on informa¬ 
tion in the CLM-created "Load Completion Data Area" in Figure 2-3. The pointers 
to LOCE and the high memory address of the loader are useful for developing load 
addresses to position floatable overlays. 

Overlay Coding Conventions 

The use of overlay processing requires an understanding of the way in which 
root and overlay segments are defined for processing by the Linker, and the 
relationships between root and overlay segments. 
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Modules to be processed as overlays are identified as such when they are 
linked. The following Linker commands identify the root modules and overlays, 
and specify the position of overlays in relation to the root module. 

NAME - Identifies the root module. 

1ST - Marks the location of initialization code in the root. 

OVLY - Names the overlay module. 

BASE - Positions the overlay module. 

In response to information placed in the load module by the Linker when it pro¬ 
cesses these commands, the CLM constructs a relative file containing the overlay 
modules; the root module remains memory resident. CLM also builds the data 
structures that the Overlay Loader uses to manipulate overlays during the execu¬ 
tion of the application. Refer to the Linker portion of the Program Development 
Tools manual for details about creation of bound units and symbol definitions. 

Example of Nonfloatable Overlays 

This example shows a root program, TCTEST, that has some initialization 
code labeled ISTTAG, and two overlays: TCTEST01, and TCTEST02. The diagram 
below shows the relationship between the root program and the two overlays; the 
letters in the modules indicate symbols that are either defined (D) in a module, 
or referred to (R). 

When it is loaded, overlay TCTEST01 is located at ISTTAG; overlay TCTEST02 
is located at ISTTAG+100, as shown below. 



XLOC 

X 

(R) 

XDEF 

Y 

(D) 

XLOC 

W 

(R) 


TEST02 


The Linker commands to 


create the bound unit are: 


NAME TCTEST 
LINKN TCTEST 
EDEF W 

1ST ISTTAG 

OVLY TCTEST01 

BASE ISTTAG 
LINKN TEST01 


Name used in the ADMOD command. 

Links root. 

Defines symbol externally referred to from 
outside the bound unit (not shown). 

Defines initialization code and overlay 
position. 

Names first overlay; Linker writes root to 
disk. 

Indicates position of first overlay. 

Links first overlay. 
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EDEF X 

OVLY TCTEST02 

BASE ISTTAG+100 
LINKN TEST02 
EDEF Y 
END 


Defines externally referenced symbol. 

Names second overlay; Linker writes first 
overlay to disk. 

Indicates position of second overlay. 

Links second overlay. 

Defines externally referenced symbol. 

Completes definition of bound unit; Linker 
writes second overlay to disk. 


Notice that only one 1ST command is used — only root segments may use 
initialization code. The Linker can satisfy the reference from the first over¬ 
lay to W in the root because the root is linked first. However, a reference to 
Y from TCTEST01 would cause a CLM error halt — the Linker writes TCTEST01 to 
disk with Y as an unresolved symbol, and CLM will not write an overlay to its 
file if it contains an undefined symbol. 


A reference from an overlay to W in the root is legitimate because the 
Linker retains all symbol definitions not purged by subsequent BASE commands 
affecting the same area. References from the root to X and Y defined in the 
overlays require EDEF statements in the overlay command group because the CLM 
must resolve the references when these modules are loaded. (The Linker was 
unable to resolve the references before the root load module was written to 
disk.) 


The EDEF definition for W in the root module is superfluous for this 
example, but illustrates another requirement for symbol definition, namely that 
an EDEF statement is needed when a symbol is referred to from outside its own 
bound unit. 

When the application using the bound unit shown in the example above is 
configured, the CLM receives this ADMOD command: 

ADMOD filenamerTCTEST ... 


As a result, the CLM will load the root segment and its initialization code into 
memory following any code loaded as a result of previous ADMOD statements. The 
initialization code beginning at ISTTAG is executed before loading the first 
overlay. Then, using the information specified in the BASE command for the 
first overlay, that segment is loaded. If the overlay has no undefined symbols, 
it will be written out to a temporary file. 

Finally, the second overlay is loaded starting at ISTTAG+100, and written 
out to the temporary file. The CLM continues to process command statements. 
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Example of Floatable Overlays 


This example illustrates a bound unit whose root has dedicated areas within 
it, and whose overlay segments are all floatable (dynamically relocatable). 


ABC 


ROOT 



01 

02 


nn 




The Linker commands to create this bound unit are: 


NAME 

ABC 

Provides name to be used 
command. 

in the ADMOD 

LINKN 

A 

Links root segment. 


OVLY 

ABC 01 

Names the first overlay; 
root to disk. 

Linker writes 

BASE 

Al 

Locates overlay. 


LINKN 

ABC 01 

Links first overlay. 


OVLY 

ABC 0 2 

Names second overlay; Linker writes first 
overlay to disk. 

BASE 

Al 

Locates overlay. 


LINKN 

ABC 02 

Links second overlay. 


OVLY 

ABCnn 



BASE 

Al 



LINKN 

ABCnn 



END 





The overlays in this example are all floatable, so that the code in the 
root and the overlays could include load addresses developed from the CLM- 
supplied pointers in low memory as described earlier. 

Note that the ADMOD command for ABC must be positioned in the CLM command 
sequence in such a way that the largest floatable overlay to be written out by 
CLM may be loaded into memory below location LOCX (Figure 2-3). This can be 
accomplished by having other ADMOD commands, whose modules occupy at least as 
much space as the largest ABC overlay, follow the ADMOD for ABC. 

After loading is completed, the overlays are brought into memory areas pre¬ 
viously occupied by CLM by calling the Overlay Loader. 
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The CLM determines the final size of a bound unit (and thereby the location 
where the next load module begins) based on the highest address occupied by 
either the root or one of its nonfloatable overlays. This means that the root 
alone in the floatable overlay example determines the bound unit size. If the 
root does not include overlay areas within it (e.g., by using a RESV assembly 
statement), those areas must be obtained in alternate ways. 

Care must be taken in source code to produce a floatable overlay. However, 
an overlay may inadvertently be coded (or later modified) so that it matches the 
definition of a floatable overlay.. To prevent a change in CLM operation 
resulting from a nonfloatable overlay becoming floatable, the source code of the 
nonfloatable overlay could include a global reference to an address tag within 
that same source. 

How to Estimate Overlay File Size 

The CLM assumes that there is enough physically contiguous space in the 
relative file it uses for the application overlays. If this is not true, por¬ 
tions of the disk beyond the allocated file space will be destroyed. The CLM 
also assumes that the name of the relative file it will use to contain the over¬ 
lays is either OVERLAY, or the filename used in the AT03 command to the Command 
Processor. 

To estimate how many sectors should be allocated when using the utility 
initialize function, take these steps: 

1. Produce link maps for all overlay load members. 

2. Determine the number of words in the image text of each one. 

3. Divide the image text word total by the number of words per 
sector (64 for diskette; 128 for cartridge disk) to obtain the 
number of sectors for each overlay. 

4. -Add the individual sector requirements together to get the total. 

5. Add in the Online Debug Program sector requirement (22 for disk¬ 
ette; 22 for cartridge disk), if needed. (This is always a good 
idea, because you may need the ODP later.) 

It is important to note that each overlay begins on a sector boundary so 
that it may be read into memory (and written out by the CLM) as a single I/O 
transfer. This design minimizes overlay load time during execution. 

INITIALIZATION SUBROUTINES 

Initialization subroutines may or may not be required by every module. As 
you write the initialization code for your modules, you may want to use one or 
more of the system-provided subroutines summarized in Table 2-7. These subrou¬ 
tines use the standard register conventions that you will also use when you 
write your subroutines. 
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Table 2-7. Register Use by System Initialization Subroutines 


Module 

Function 


Register Contents 

Name 

Code 

Function 

For Function Call 

After Function End 

ZGFINU 

0 

Find a symbol in 
symbol list 

B4 - Pointer to 

start of symbol 
name 

Rl - 0 = Symbol found 

nonzero = Not 
found 

ZGDEFU 

1 

Define a symbol 

Rl - 0 = Address 
definition 

Value = Value 
definition 

R2 - Definition 
value 

B3 - Definition 
address 

Rl - 0 = No error 

IF = Symbol 
already defined 

21 = Work area 
overlap 

ZGREFU 

2 

Refer to a symbol 

Rl - 0 = Address 
reference 

Value = Value 
reference 

Bl - Pointer to 

location refer¬ 
red to 

Rl - 0 = No error 

21 = Work area 
overlap 


NOTES: 1. These registers have the same values for all functions: 

R3 - function code; B4 - pointer to the start of the symbol 
name; B5 - return address. 


2. Other registers used by these subroutines: R4, R7 , B2, B7, R6. 


Initialization is performed immediately after the loading of a module is 
completed. Each initialization subroutine is entered via the LNJ instruction 
using register B5 for the return address. The address of the parameter list is 
loaded into register B4, the parameter list itself is defined in the initializa¬ 
tion subroutine table described below. 


Errors occurring during initialization are fatal errors; loading cannot be 
continued. Error information is returned in register Rl; CLM moves the contents 
of Rl to R2 and places the 1304 halt code into Rl. If the content of register 
Rl is zero, the operation was successful. 

The initialization subroutine table identifies the subroutines that are to 
be executed when the module has been loaded. It has the following format: 
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label 


DC 

0 

next load displacement 

RESV 

$AF, 0 

RFU 

DC 

<name 

first initialization subroutine 

DC 

value 

parameter It £or first subroutine 

DC 

value 

parameter 2 J 

DC 

<name 

second initialization subroutine 

DC 

value 

parameter 1\ £ or secon( ^ subroutine 

DC 

• 

value 

parameter 2) 

RESV 

$AF, 0 

sentinel, end of 1ST 


# 

. 

• 


* 


Entries must be included in the initialization subroutine table for each 
subroutine required for a load module. The "label" in the first statement of 
the format example must be defined in an 1ST command to the Linker. The location 
at "label" is the point at which the next module will be loaded when the initial¬ 
ization is completed. Normally, the value declared at "label" is zero. 


During the CLM loading phase, the base address for loading the next load 
module is formed by using the address of the first word of the current load 
module's initialization subroutine table (1ST in the example) plus the displace¬ 
ment value contained in that word. When the displacement is nonzero, the next 
module loads below (for a negative displacement) or above (for a positive 
displacement) the 1ST start address. 


Communications Planning 

The Communications functions of BES software have been designed in such a 
way as to make them as easy to use as any other peripheral device. Your inter¬ 
action with the Communications software occurs through the physical I/O inter¬ 
face. Using the Configuration Load Manager, you assign a logical resource 
number to the various Communications devices. Then, in your application program, 
using a standard call to the Executive, and providing a standard control struc¬ 
ture (an IORB) in which to pass parameters, you request a transaction with a 
particular communications resource. Your request is then handled by the 
Communications software, and you need not be concerned with the details of 
Communications procedure. See the IORB information in the Executive and Input/ 
Output manual for details about the standard control structures and function 
codes for Communications devices. 


PRIORITY LEVEL REQUIREMENTS FOR COMMUNICATIONS 

Although both peripheral and Communications devices share a common inter¬ 
face, they have different priority level requirements. Peripheral devices such 
as card readers, disks, and printers are assigned one device to a level. Com¬ 
munications devices, however, require one dedicated level (specified in the COMM 
command) that is reserved for the processing of Communications interrupts, and 
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must be the highest priority level assigned to a Communications function. 
Additionally, any number of priority levels may be shared among Communications 
devices ( not with any other device types); these priority levels must be lower 
(higher level numbers) than the level specified in the COMM command. 

REQUESTING COMMUNICATIONS FUNCTIONS 

When you request a transaction with a communications resource, you must 
specify the logical function in the request block that you provide with each 
request. 

There are five logical functions: connect, read, write, wait-on-line, and 
disconnect. The connect must precede other requests, because Communications 
resources are configured in a disconnected state. The sequence that would occur 
is as follows: 

1. Set up an IORB with the function code for a connect request, and 
call the physical I/O interface. 

2. Once the connection is made, you supply the appropriate request 
blocks for the functions that your application will perform, and 
do the reads, writes, and/or wait-on-line operations required by 
the program's logic. 

3. When the program finishes processing, you supply a request block 
with the disconnect function code, and call the physical I/O 
interface to perform the function. 

The values that you provide for the various function codes are coded in the 
last four bits of word three (ZIRCT2) of the IORB that you supply in your 
application program. 

If your application is such that the program must: 

• Temporarily suppress the previously queued data request to or from 
a VIP or TTY, or 

• Signal a traffic direction change for a device (BSC) 

there is a means of disconnecting the resource logically while maintaining the 
physical line connection. This logical disconnection is accomplished when bit 
15 of the device-specific word of the IORB is set on; when this bit is zero, the 
physical line connection is discontinued. 

The Communications function codes (CONNECT and DISCONNECT) may be used with 
no effect if a program whose IORB's contain such codes were to be executed using 
noncommunications peripheral devices, thus the program is independent of the 
device types that may be in use. 

COBOL application programs can use the Communications facilities of BES 
software by the standard input/output verbs OPEN and CLOSE; these verbs evoke 
the Communications connect and disconnect functions, respectively. 
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BINARY SYNCHRONOUS COMMUNICATIONS (BSC 2780) 


This Communications protocol may be used in conjunction with an appropriate 
application program in the following ways: 

• IBM 2780 remote terminal emulator 

• File transmission for Level 6-to-Level 6 computers 
IBM 2780 Remote Terminal Emulation 

In this environment an application program would be structured to emulate 
the functions of the IBM 2780 remote terminal in a manner which is consistent 
with the features available on the host computer responsible for processing the 
submitted data. 

The features of BES2 BSC 2780 line protocol are described below. 

Level 6-to-Level 6 File Transmission 

In this environment an application program could be developed to transmit 
both binary and ASCII data, in records of any size, between two Level 6 
computers. 

The support of the character sets (whether ASCII or EBCDIC) is restricted 
to the line protocol handler providing the control characters in the appropriate 
character set. 


The character set of the text portion of the data is totally the responsi¬ 
bility of the application program. 

In transparent EBCDIC, the line protocol handler will assume total responsi¬ 
bility for inserting and removing the line protocol escape character (DLE) both 
in the header and in the text. 


Whether a transmission unit from Level 6 will contain a single record or 
two records may be managed by the application program in the following way: 

• Creation of single record transmission units requires that each 
write order be issued with the wait status specified in the IORB. 

• Creation of two-record transmission units requires that each write 
order be issued with the do-not-wait status specified in the IORB. 

In this situation, the application would do the necessary processing 
and issue another write order with the do-not-wait status specified 
in the IORB. The process continues, the application program pro¬ 
cesses in a totally independent manner, without regard for the 
activity on the Communications line until the application program's 
write buffers are filled. At this point, a wait on the first IORB 
is issued. When the application program resumes, it again does its 
processing, and issues another write order (do-not-wait). Then a 
wait on the second IORB is issued, and so on. 
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The packaging of the write requests into a transmission unit is done 
independently by the line protocol handler. A second record will be embedded in 
the transmission unit as long as the write request is issued before the last 
character of the previous write request has been transmitted over the Communica¬ 
tions line. As a practical matter, considering the comparative slowness of the 
communications line (maximum 1200 characters/second) with other resources 
(computer, peripherals, etc.), there is sufficient time to allow this free¬ 
wheeling process to work. 

If an application program is by convention to be prepared to handle the 
receipt of data from an application that transmits two records in a single 
transmission unit, then it is required that two read requests always be present 
at any time during which a transmission unit may be received. 

A basic characteristic of the BSC 2780 communications protocol is that it 
is nonconversational. That is, once the movement of data has been established 
between computers (i.e., from A to B), it is not possible to transmit from B to 
A until the entire quantity of data has been transmitted from A to B. Occa¬ 
sionally, there may be a need to send an urgent preemptive message in the direc¬ 
tion contrary to the flow of information. This need is resolved by computer B 
issuing a disconnect request with the indicator set to abort all IORB's in the 
queue. Upon notification of this action being complete, it is now possible for 
the application program in computer B to issue a connect request followed by 
the write order for the urgent message. 

When computer A received the notification from computer B of the urgent 
preemptive need to send a message (signaled in BSC 2780 by the receipt of a 
reverse interrupt, RVI) it would so notify the application program via the 
attention interface, after dequeuing and posting all currently queued IORB's. 

The application program would then issue a receive order for the acceptance of 
the preemptive message. 
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SECTION 3 
BUILDING 


The Configuration Load Manager (CLM) defines the application variables, 
sets up the required internal control structures, prepares a load list of the 
specified modules, and initiates the execution of the application, all in one 
continuous operation. 

Before executing the CLM, you must have already prepared the programs and 
files to be used in the application. This preparation includes compiling (or 
assembling) the programs, linking them into one or more load modules, and pre¬ 
allocating space for all output files to be used. 

During the configuration phase, CLM accepts the commands that direct its 
operation. In addition to specifying system characteristics such as memory size 
and processor type, the commands processed by CLM also set priority levels for 
tasks, assign logical resource numbers, and direct the construction of a load 
module list containing the names of all the modules to be loaded for execution. 

Once the configuration phase is completed, the modules named in the load 
module list are loaded by the particular loader then in use. Any unresolved 
references among the modules are resolved at this time. As each module is 
loaded, it is initialized before the next module is loaded. 

After the last module is loaded and initialized, control is transferred to 
the active task having the highest priority. Execution then begins. 

PREPARING TO USE CLM 

Since CLM allows an application to be run as a single load-and-go operation, 
all files to be used for output by the application should be preallocated, and 
all modules, both Executive as well as user-written modules, should be linked 
before the CLM is loaded into memory. These preliminary processes are described 
in the appropriate manuals, and illustrated in Figure 3-1. The process of 
building an online application falls naturally into discrete steps. The fol¬ 
lowing pages describe the process and refer you to the pertinent manuals for 
complete details. 
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STAGE 1 


STAGE 2 


STAGE 3 


STAGE 4 


STAGE 5 


STAGE 6 


Figure 
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3-1. Building an Online Application - Process Diagram 
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Output File Preallocation (Stage 1) 

Figure 3-1 summarizes the file requirements for all the following stages in 
the application development process. File space is allocated by Utility Set 1. 
(See the Utility Programs manual.) Some of the files your application uses must 
be relative files to receive either the output data from the application, or, if 
you are using overlays, the overlay file written by CLM. 

The file to accommodate any overlays that CLM writes out in the process of 
application configuration must be a single extent, relative file large enough to 
hold all the application's overlays. If the overlay version of the Online Debug 
Program is being used, the overlay file must provide 50 diskette sectors, or 25 
disk sectors in addition to the space required for other overlays. 

Files that are intended to receive source, object, or load modules must be 
initialized after space is allocated, to organize those files as partitioned 
files capable of accommodating individually accessible members. 

If you plan to use the Online Debug Program with predefined command lines 
stored on disk, you must preallocate a relative file named DEBUG.WORK containing 
22 diskette sectors, or cartridge disk sectors for use by this program. 

If your application program produces an output file that is intended for 
printing by a print utility, either immediately, or at a later time, the first 
byte of each record to be printed must contain printer control information. 

Source Module Creation and Editing (Stages 2 and 3) 

Partitioned files containing source text members are created on disk from 
punched card files using Utility Set 2. once created, these source files are 
then usable by the Editor, for correction or addition of text, or they may serve 
as input to the Assembler or to the FORTRAN or COBOL Compiler. (See Program 
Development Tools manual.) 

Stage 2 is mandatory if source programs are punched on cards; it may be 
omitted entirely if the source programs are short enough to be entered through 
the keyboard as input to the Editor. 

Stage 3 is optional. It is possible to go directly from creating a source 
file on disk to the Assembler/Compiler phase. 
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Object Module Creation (Stage 4) 


The creation of object modules is the function of three system programs: 
the Assembler for programs written in assembly language; the FORTRAN Compiler, 
and the COBOL Compiler, for programs written in FORTRAN or COBOL source language 
In addition to object modules produced on disk, the Assembler and both compilers 
produce source listings with diagnostic messages that refer to the various 
syntactical errors encountered in the processing of the source language state¬ 
ments . 

Once the source code is free of syntax errors, and has been reassembled or 
recompiled, the program is ready to be processed by the Linker in the next phase 

Load Module Creation (Stage 5) 

The preparation of load modules for use in online applications requires 
special attention to the ordering of permanent code and the initialization code 
for particular load modules, and to the handling of externally defined symbols. 

LINKING ORDER FOR CODE TEXT 

One or more object modules may be linked to form a load module. The order 
in which modules are linked is significant in the following situations: 

• Modules being linked require initialization code. 

• Modules being linked will be executed as overlays. 

Load modules that require initialization code must have all permanent code 
linked before the initialization code for the load module. This is because, 
during the loading phase in the operation of CLM, successive modules are loaded 
in such a way that once the initialization code for a module is executed, it is 
replaced by the permanent code of the next module. Figure 3-2 shows the memory 
layout of a module and its initialization routines, and indicates the starting 
location for loading the next module once the initialization has been performed. 

EXTERNALLY DEFINED SYMBOLS 

An application load module may have valid undefined symbols at the time it 
is linked, such as a call to an Executive subroutine. The CLM resolves these 
references as it loads the Executive Modules specified in the ADMOD, DEVICE, and 
Communications line type processor commands, and analyzes the ELOC, EVAL, TRAP 
and DEVICE commands. 

Any symbol that may be referred to by other load modules or by the CLM, and 
not defined by CLM itself, must be identified in an EDEF statement at the time 
the module is linked. (See the Program Development Tools manual for Linker 
information.) 
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Figure 3-2. Current Load Module Memory Layout 

In assembly language, locations or values that are referred to by modules 
other than the one in which they are defined, are identified in an XDEF state¬ 
ment; when the defining module is linked, the label (s) made available for 
external reference by these XDEF statements are declared in a Linker EDEF state¬ 
ment if CLM must resolve references to these labels in other modules. 

During configuration, the CLM must be able to resolve all references either 
from information provided to it in a symbol table from the Linker, or from the 
symbol table CLM itself constructs from the command information submitted to it. 
The unresolved symbols encountered by CLM during execution cause a load error 
(1341 — see the Operator's Guide) followed by a halt; at your discretion, you 
can ignore these errors and continue processing. However, there are load errors 
that prevent continued execution of CLM: the occurrence of an undefined symbol 
in an overlay module (135B — see the Operator's Guide). 

There are several CLM command parameters that require Linker EDEF state¬ 
ments: the start address in a TASK command; the ppt-label and space-name in the 

BUFSPACE command; the handler-name in a TRAP command; the label parameter of a 
DEVICE, TTY, VIP, or BSC command if the label specifies a user-defined routine 
and is not the default label, ZIATTN for LRN 0. 
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Summary of Load Module Preparation 

These are the steps involved in the preparation of load modules prior to 
configuring an online application: 

• Collect the object modules that make up the permanent code. 

• Collect the system initialization modules to be used. 

• Write and assemble the user-written initialization code and the 
initialization subroutine table. 

• Run the Linker to produce a load module in the format described in 
Figure 3-2. Note that the initialization subroutine table is always 
linked immediately following the permanent code text. It is at this 
point in the process that the Linker EDEF command is used to specify 
all externally-referenced symbols. 

USING THE CONFIGURATION LOAD MANAGER (STAGE 6) 

The CLM and its extensions are the BES software components you use to 
configure an online application. 

CLM consists of four functional groups of modules that interpret the com¬ 
mands in which you have specified the system variables, devices, and load modules 
that constitute the configured application. Of these functional groups, one, 
the CLM nucleus is required for configuring all applications; the other three 
are optional extensions that interpret particular configuration commands. 

Depending on the memory size of your system, the optional modules may be 
resident throughout the operation of CLM, or, as with an 8K system, the CLM 
extensions must be executed as overlays. Table 3-1 summarizes the functional 
groups and indicates the commands that are interpreted by each. 

How to Include Optional CLM Extensions 

The CLM extensions that interpret the File and Buffer Management, and 
Communications commands are included by specifying the appropriate information 
in a LACT command for each extension. The LACT command contains a parameter to 
indicate that an extension is to be executed as an overlay. (See Appendix A.) 

The following example shows the LACT commands for a communications applica¬ 
tion whose devices are accessed through the File Manager, and that will require 
device definitions that include the File Manager DEVFILE command. 

LACT CLMCOMM:COMM 
LACT PROGFILE:CLMFIL 


The channel number is the same as that from which CLM was loaded, the work areas 
for both sets of modules will not be shared, and both sets of interpretive 
modules will be resident rather than overlays. 
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Table 3-1. CLM Functional Groups, Component Modules and Related Commands 


Functional Group 
(filename:membername) 

Component Modules 

Commands Processed 

PROGFILE:CLM 
(required) 

CLM Nucleus 

CLM 

CLM2 

CLMSTl 

D$CLMST1 

C$CLMST1 

CLMST2 

D$CLMST2 

SYS ADMOD TRAP 

OIM PRMOD LACT 

TSA ELOC ELACT 

CLOCK EVAL QUIT 

DATE IOS * 

TASK EQLRN 

DEVICE ATLRN 

PROGFILE:CLMFIL 
(optional) 

File Manager Extensions 

CLMFIL 

D$CLMFIL 

C$CLMFIL 

FILMGR DEVFILE 
ATFILE FMDISK 

PROGFILE:CLMBUF 
(optional) 

Buffer Manager Extensions 

BUFSPACE 

CLMBUF 

D$CLMBUF 

C$CLMBUF 

CLMCOMM:COMM 
(optional) 

Communications Extensions 

COMM BSC 

TTY MODEM 

VIP LTPDEF 

LTPn STATION 

COMM 

D$COMM 

C$COMM 

a As specified in the LACT command 


If the extensions are executed as overlays, it is not necessary, but more 
efficient to group the configuration commands in the same order as the exten¬ 
sions were specified. The grouping of commands becomes particularly important 
if your application is configured from a serial device. (See "Loading From 
Paper Tape," discussed later in this section.) 


After the CLM nucleus has been loaded, the only commands that it will pro¬ 
cess are the LACT and IOS commands, until an ELACT command is read. In fact, 
even if you do not add any of the CLM extensions, an ELACT command must be 
issued so that CLM may begin processing the other application configuration 
commands. 


To summarize; the optional CLM extensions may be executed as resident 
modules, or they may be executed as overlays; in an 8K environment the exten¬ 
sions must be executed as overlays; unlike the execution of application program 
overlays that require the availability of a disk, CLM extension overlays have no 
such requirement. 
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Application Configuration and Loading 

You can load CLM and configure your application from disk or paper tape, 
either as a nonstop procedure (disk only), or a load-and-halt operation; you 
can use, but do not need, an operator’s console. Specific operating procedures 
for all methods are described in the Operator's Guide, and discussed briefly in 
the following pages. 

NONSTOP APPLICATION LOADING 

The nonstop loading procedure is based on a preset bootstrap record created 
by the Bootstrap Generator utility program. The elements of this record are 
described in Table 3-2. (For details, see the Utility Programs manual.) 

Table 3-2. Bootstrap Record for Nonstop CLM Loading 


Parameter 

Values 

Default Values 

DFT 

N 


None 

BTHLT 

N 


N 

HMA (high memory address) 

1FFF 

(8K) ) 



3FFF 

(16K)( 

1FFF 


7FFF 

(3 2 K ) ( 


FFFF 

(64K)) 


KSR 

0 


0500 

LDCHN (load channel) 

0400 

(disk) 

0 


f 

(paper tape) 

FILE 

PROGFILE 

PROGFILE 

MEMBER 

CLM 


CMDPRC 

REL (relocation factor) 

xxxx a 

(8K) ) 



XXXX 

(16K) l 

0 


XXXX 

(32K) ( 


XXXX 

(64K) ) 


LDHLT 

N 


N 

a See Release Bulletin for exact values 


The nonstop loading procedure is usable only when your load modules are on 
disk; no operator's console is needed. 

The file requirements for nonstop loading from disk are these: the CLM 
command input file (CLMCI) must be on disk. If you are running your application 
program as overlays, you must preallocate a relative file for CLM to use when it 
writes out the overlays. 

If you are configuring a communications application, then in addition to 
PROGFILE, your disk should contain CLMCOMM. 
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The Bootstrap Generator Utility program is executed to place the preset 
bootstrap record on the disk. The parameters for the utility, assuming a 16K 
system, are: 


N,,3FFF,0,0400,,CLM,3480 

When this record is on the disk, and all the load modules needed by the 
application are available, you are ready to carry out the loading procedure. 

You press: Stop, Clear, Load, and Execute; there will be a pause while the QLT 
(Quality Logic Test) is performed, then press Execute again, and application 
configuration is underway and needs no further intervention. 

LOADING FROM DISK USING THE COMMAND PROCESSOR 

This method involves minimal operator intervention, but allows the command 
input file to the CLM to be reassigned from the KSR to either a disk on a dif¬ 
ferent channel, or with a nondefault member name, or card file. The method also 
requires a preset bootstrap record, but this time the default values for the 
file and member entries in Table 3-2 can be taken; those entries are PROGFILE 
and CMDPRC, respectively. 

The parameters for the Bootstrap Generator utility program, again assuming 
a 16K system are: 


N,,3FFF,,,,,3480 

When you are ready to carry out the loading procedure, press: Stop, Clear, 

Load, and Execute; after the QLT has executed, again press Execute. The Command 
Processor indicates its availability by printing a C? on the console; at this 
point you can use the EX command to assign a command input file that loads CLM 
with appropriate attachments for configuring your application. No further 
operator intervention is needed. 

LOAD AND HALT PROCEDURES FOR DISK 

These procedures can be carried out using either an operator's console or 
the control panel if no console is available. Both methods are described below. 

Loading From Disk With an Operator's Console 

When the load device is a disk and an operator's console is available, CLM 
is loaded using the Command Processor in conjunction with the Disk Loader. The 
Command Processor accepts control information through the console to establish 
the environment for the execution of the CLM. (See the Program Development 
Tools manual for a description of the Command Processor.) 
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The commands entered through the console specify a relocation factor, and 
whether a halt should occur after CLM is loaded (e.g., to allow the mounting of 
a new disk). In addition, the commands specify the command input file name; the 
overlay file name, if necessary; and the device and channel number from which 
the CLM commands will be entered. 

The last Command Processor command causes the CLM to be loaded. If no halt 
was specified, the CLM starts executing as soon as it is loaded. Otherwise, the 
system halts, allowing you to perform any necessary actions before continuing. 

Loading From Disk Without an Operator's Console 

In this method, no Command Processor is usable. If the load parameters 
vary from load to load, they can be entered through the control panel, with a 
bootstrap record on disk set up to halt as described below. 

The bootstrap record parameters BTHLT and LDHLT are, in this case, set to 

Y. 


When the bootstrap record has been written on the disk, you can begin the 
loading procedure. Make sure that your disk is on the device that is connected 
to the default bootstrap channel (0400^). Press: Stop, Clear, Load, Execute 
(QLT pause), Execute. 

When the 1601 halt occurs, press £top, and then you can enter the reloca¬ 
tion factor into register B2, the HMA into B3, and the loading channel number 
into R2. Then press Ready and Execute. 

When the 1603 halt occurs, you can choose the CLM command input device and 
channel number by: pressing Stop, entering the channel number of the command 
input device into R6, and the device type into R7. The device types are: 0040 
for a card reader, 0080 for a disk. Press Ready and Execute. Control is now 
turned over to CLM and configuration of the application proceeds. 

LOADING FROM PAPER TAPE 

The only procedure available for this medium is a load and halt procedure 
because the command file for CLM cannot be entered from paper tape. You can 
minimize halting by setting most values in the bootstrap record, but the LDHLT 
parameter should be given a value of Y so that you can assign the command file 
to the appropriate device. 

Since paper tape is a serial medium, all elements must appear in the order 
in which they are to be used. The first element on the tape must be the boot¬ 
strap record; when the Bootstrap Generator program is executed to create the 
bootstrap record, the utility also places the next required module on the tape. 
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namely, the Paper Tape Loader. Table 3-3 shows the order of CLM modules 
required for paper tape loading. See the Operator's Guide for complete details 
about all loading procedures. 


Table 3-3. CLM Load Module Order for Paper Tape 


Memory 

Size 

HMA=1FFF (8K) 

HMA>1FFF (8K) 

CLM 

CLM 

CLM2 

CLM2 

D$CLMST1 

D$CLMST1 

D$CLMST2 

D$CLM3T2 

D$COMM a 

D$COMM a 

D$CLMFIL a 

D$CLMFIL a 

D$CLMBUF a 

D$CLMBUF 3 

CLMSTl b 

CLMSTl 

CLMST2 

C$CLMST1 

COMM a 

CLMST2 

CLMFIL 3 

COMM 3 

CLMBUF a 

CLMFIL 3 

C$CLMST1 

C$COMM 3 

C$COMM a 

C$CLMFIL 3 

C$CLMFIL a 

CLMBUF 3 

C$CLMBUF a 

C$CLMBUF 3 

a These modules are included 
only if the appropriate LACT 
commands are issued. 

^Modules beginning with this 
one are loaded as needed, and 
in order of LACT command 
submission when memory size 
is 8K. The above list 
assumes that the LACT com¬ 
mands were issued for COMM, 
CLMFIL, and CLMBUF in that 
order; consequently, con¬ 
figuration commands should be 
issued in the same order. 

Also, for 8K systems, the C$ 
modules will be loaded after 
the QUIT command is pro¬ 
cessed. 

If HMA is greater than 8K, 
all CLM modules will be 
loaded before any system con¬ 
figuration commands are 
requested, so there is no 
necessity to group these com¬ 
mands in this case. 
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Building a CLM Command File 

The order of command submission to the CLM depends on the type of applica¬ 
tion being configured. If, for example, you are including one or more of the 
CLM extensions, then the LACT commands are presented first, followed by an ELACT 
command. If no extensions are included, the ELACT command must be issued so that 
the CLM can begin to accept system configuration commands. 

As to the submission order of the system configuration commands themselves, 
several factors have an effect upon what the final order should be: memory size 
in combination with disk availability, the nature of the loading medium, and the 
characteristics of the modules that make up the application. 

As mentioned earlier under "How to Include Optional CLM Extensions," running 
CLM extensions as overlays is mandatory for 8K systems. Similarly, if memory 
size is limited, and you are running your own programs as overlays, then the 
order in which the ADMOD commands are submitted could be important if references 
are made from one bound unit to another. 

The nature of the loading medium can affect the grouping of commands as 
described previously, under "Loading From Paper Tape." 

Finally, the characteristics of the application modules themselves must be 
considered when you are designing your command file. For example, if you are 
configuring an application that contains communications software, it is advisable 
to issue the Communications commands to the CLM early in the process. The reason 
for this is that the line-type processor modules have extensive initialization 
code which loads the RAM portion of the MLCP, so that starting the configuration 
procedure with the Communications commands allows you to use the area occupied 
by this initialization code for permanent modules loaded later in the process. 
Whereas, if you wait to bring in the Communications modules until later in the 
process, you may either waste space, or worse still, you may have to begin the 
configuration process over again because there was not enough space left for the 
initialization code to execute. 

Similarly, CLM requires space for loading and writing floatable overlays to 
disk that is usable by permanent code that is subsequently loaded. You should 
consider loading programs that have floatable overlays early in the configura¬ 
tion process. 

Apart from the actual order of the commands in the command file, the fol¬ 
lowing facts should be noted. 

Any device that will be accessed through the File Manager requires a 
DEVFILE command; the DEVFILE command must be issued after the corresponding 
DEVICE, TTY, BSC, or VIP command. 
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An error results if the OIM command is omitted from the CLM command file 
because some system services may use the TYPR facility even if user programs do 
not. 


The CLM command file should begin with a SYS command unless all the default 
values are taken, and it must end with a QUIT command. 

The command set for CLM is described in Table A-l; the definitions for all 
commands and their parameters are also found in Appendix A. 

CLM Action During Loading 

When the QUIT command is processed, the data structures are created in a 
nondedicated area of memory. Figure 3-3 shows how memory looks before the 
loading phase begins. 

When the loader is given control, it obtains the name of the first load 
module to be loaded from the load module list constructed by CLM. The first 
module is loaded beginning at a location just above that occupied by the system 
data structures. After the loading of each module is complete, control is given 
to the initialization subroutines of the module. 

At this point, if the module is a root module with overlays, the overlays 
are loaded, and written out to the overlay file. Figure 3-4 shows a memory 
layout after the loading process is completed. 

If the space name parameter of the BUFSPACE command is not given a value, 
the buffer area is obtained from the load residue space, which includes the area 
from the end of the last load module, through the value of the himem parameter 
in the SYS command. If the default value of himem is taken, the loader is 
included in the load residue area and could be overwritten by information put 
into buffers. Figure 3-5 shows how memory looks during application execution 
when the value of himem was not changed to protect the loader. 
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STARTING AN ONLINE APPLICATION 


It is important to understand how the starting point of an application is 
conveyed to the CLM, because you must take specific steps while creating applica¬ 
tion load modules to ensure that the CLM can identify the desired start address. 

Specifically, the CLM TASK command allows a task associated with a priority 
level to be started at a labeled address when the application is loaded. This 
start address label must be declared in a Linker EDEF statement when the load 
module containing the task is created. If an application has more than one task 
(each on a different priority level) to be started, multiple TASK and EDEF 
statements can be used. The EDEF's may be in the same or in different load 
modules. 

The EDEF command is used on behalf of assembly, FORTRAN, and COBOL language 
programs to define start labels to the CLM. Any label may be used in an assembly 
language program. 

For FORTRAN main programs, the label is either: 

• The "progname” used in a PROGRAM source statement in the main 
program, or 

• The compiler default label ZFMAIN^ for a main program that does not 
contain a PROGRAM source statement. 

Note that a PROGRAM statement is required in main programs if multiple start 
labels are needed. 

The rules for defining the start addresses for load modules written in 
assembly, FORTRAN, and COBOL languages are summarized below. 

Assembly Language Start Address Definition 

• Start labels chosen are declared by XDEF statements to the 
Assembler, and EDEF statements to the Linker. 

• The label in each TASK command to the CLM matches the XDEF and EDEF 
definitions. 

FORTRAN Language Start Address Definition 

• Start labels explicitly declared in PROGRAM source statements (or a 
ZFMAIN label created implicitly by the compiler) are declared in 
Linker EDEF statements. 

• The label in each TASK command to the CLM matches the EDEF defini¬ 
tion. 


■''This label is placed into the FORTRAN object (or source) output by the compiler 
using either an effective (or actual) XDEF Assembler control statement. 
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COBOL Language Start Address Definition 

• The program name in the PROGRAM-ID clause is declared in a Linker 
EDEF statement. 

• The label in a TASK statement must match the name in the EDEF 
definition. 

If the HLT parameter was coded on the QUIT command to the CLM, a halt will 
occur after the last load module has been loaded; if not, control will be given 
to the highest active priority level, and execution begins. 


3-18 


AU4 9 



SECTION 4 
DEBUGGING 


This section provides some practical approaches that may be useful to you 
when debugging an online application. These suggestions are by no means all- 
encompassing, nor intended to restrict your ingenuity in uncovering and fixing 
a software difficulty in your program. 

USING THE ONLINE DEBUG PROGRAM 

BES provides an interactive debugging component, the Online Debug Program, 
(ODP) that supplies online patching and testing facilities for application pro¬ 
grams running under the BES Executive. 

There are two versions of the ODP, one runs as a series of overlays and re¬ 
quires the BES2 Executive; the other is memory resident and can execute under the 
control of either the BES1 or BES2 Executive. Both versions require an op¬ 
erator's console; an optional, preallocated relative disk file, DEBUG.WORK is 
used when delayed execution commands are executed. Table 4-1 summarizes the 
memory and work file space for ODP. 


Table 4-1. Memory and Work File Space Usage 





File Space Used 

Module Name 

BES Executive 

Memory Needed 
(Words) 

Diskette Disk 

(Sectors) 

ZDBGl 

ZXEX02 or ZXEX03 

2700 

22 

22 

ZDBG 

ZXEX03 only 

1100 (overlay) 

72 

47 


NOTES: 1. Sector size for diskette is 128 bytes; for disk is 

256 bytes. 


2. Sector values for the overlay version include re¬ 
quired space for two different files: OVERLAY and 
DEBUG.WORK. 

3. Sector values for ZDBG1 and ZDBG represent the op¬ 
tional space provided for the DEBUG.WORK file that 
is needed only if predefined command lines are to 
be stored on disk for later execution. (See SF 

_ command.) _ 
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Online Debug Program Functions 


Online Debug Program performs the following functions: 

• Defines, stores, and executes (either immediately or after 
a delay, depending on the command) a sequence of commands 
from the console, or when breakpoints or trace trap in¬ 
structions are encountered in the program being tested. 

• Sets, clears, or prints breakpoints in task code to monitor 
task status 

• Displays, changes, and dumps either memory or registers; 
information may be printed on the operator's console, or 
a line printer 

• Evaluates expressions 
Debugging Command Language 

Commands are submitted to the Online Debug Program through the operator's 
console or any command terminal. A command line may consist of one or more de¬ 
bugging commands separated by a semicolon and terminated by a carriage return. 
Some of the commands are executed immediately, and some, by their nature, are 
executed on a delayed basis. The "predefined" or "delayed execution" commands 
are stored on disk prior to execution. 

Within commands, parameters are separated from one another by one or more 
spaces. All parameter values are entered using hexadecimal notation. 

Any command that produces printed output may direct the output to a device 
other than the operator's console by using the LRN (logical resource number) of 
the device; when no LRN is specified, the operator's console receives the output. 

Table 4-2 summarizes the debugging commands by function. The following 
pages present detailed descriptions of the commands and their use. 

Table 4-2. Summary of Debugging Commands by Function 


Function 

Command 

Mnemonic 

Meaning 

Command line 

Dn 

Define command line n 

definition and 

En 

Execute command line n 

handling 



Print all predefined command lines 



Print command line n 

Breakpoint 


Clear all breakpoints 

control 


Clear breakpoint n 




Proceed from breakpoint 



List all breakpoints 


Ln 

List breakpoint n and associated command line 


Sn 

Set breakpoint n 
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Table 4-2 (cont). Summary of Debugging Commands by Function 



Command 


Function 

Mnemonic 

Meaning 

Trace trap 

DT 

Define trace command line 

control 

PT 

Print trace command line 

Active level 

SL 

Set current and active level 

control 

TL 

Establish temporary level active 

Memory and 

AR 

Print contents of all active level registers 

register 

control 

CH 

Change memory 


DH 

Display memory in hexadecimal 


DP 

Display memory in hexadecimal and ASCII 

Symbol control 

AS 

Assign a hexadecimal value to symbol 


VH 

Print value of expression in hexadecimal 

General execution 

AL 

Activate level(s) 


Hn 

Print header line 


LL 

Line length of console in use 


RF 

Reset file location 


SF 

Specify file location 


DEBUGGING COMMAND FORMAT AND SYMBOLOGY 

The format of debugging command lines is: 

command-mnemonicAparamAparam;command-mnemonicAparam;. . . ;CR 

The symbols in Table 4-3 are used in the command descriptions and examples 
that appear below. 
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Table 4-3. Symbols Used in Debugging Command Lines 


Symbol Type 

Meaning 

Arithmetic Operators 


plus sign (+) 

Performs addition. 

minus sign (-) 

Performs subtraction. 

K 

Multiplies a hexadecimal integer by 1024 decimal (400 in 
hexadecimal) when K is the last character of an integer 
expression. 

Address Operators 


period (.) 

Represents the last start address used in a previous mem¬ 
ory reference command (DH,CH,DP). 

ampersand (&) 

Represents the address of the next location beyond’the 
last one used by a previous memory reference command 
(DH,CH,DP) . 

brackets [ ] 

Signifies the contents of the location defined by the ex¬ 
pression within the brackets. Three levels of nesting 
may be used. 

Reserved Symbols 


$Bn 

Contents of base register n of the active level. The 
values 1 through 7 can be used for n. 

$Rn 

Contents of the data register n of the active level. 

The values 1 through 7 can be used for n. 

$P 

Contents of the program counter of the active level. 

$1 

Contents of the indicator register of the active level. 

$S 

Contents of the system status register (level number 
and privilege bit only) of the active level. 

$SL 

Represents the value of the level number of the active 
level. 

G through Z 

Twenty single-character temporary symbols having initial 
values of zero. Values may be assigned using the AS 
debugging command. 

Notational symbols 


braces { } 

Indicate optional parameters. 

ellipses . . . 

Indicates the ability to repeat parameters within braces. 

parentheses ( ) 

Indicate command or header information to be stored for 
later use. Unmatched right parenthesis results in an 
error. A right parenthesis that is paired with the first 
left parenthesis terminates the command definition. 

exp 

Indicates a valid expression formed using expression 
elements. 

rexp 

Consists of expl/exp2 where expl is a hexadecimal 
number that is a value or a location; exp2 is an option¬ 
al hexadecimal repeat factor whose value must be between 

1 and 32,767. If exp2 is omitted, the value of 1 is 
assumed. 

slash (/) 

Brings Online Debug Program to command level; also used 
to indicate reference to specific LRN for the command 
use. 

Delta (A) 

Indicates a space. 

CR 

Indicates a carriage return. 

t 

Separation character between commands on the same command 
line. 

* 

Signifies "all" in the print and clear commands. 
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al/ar/as/c* 


Debugging Commands 
ACTIVATE LEVEL COMMAND (AL) 

Command activates a level corresponding to each expression. 
Format: 

ALAexp|AexpA. . . [ CR 

Example: 

AL A A+2 CR 

This example activates priority levels 10 and 12 (decimal) 


ALL REGISTERS COMMAND (AR) 

Command causes the printing of all registers for the active level. 
Format: 


ARj/lrnJCR 


Example: 

AR/3 CR 

This example causes the contents of all the registers for the active 
level to be printed on the device referred to as logical resource 
number 3. (See Note 6, under "Additional Operating Notes for the 
Online Debug Program", below) 


ASSIGN COMMAND (AS) 

Command assigns the hexadecimal value of the expression to the symbol; used 
to alter registers of the active level, and temporary symbols. 

Format: 


ASAsymAexpj AsymAexp ...}CR 


Example: 

AS $R1 -2 X 1408 $B7 X+15 

This example causes -2 to be assigned to data register 1 and 141D 
to be assigned to base register 7, and 1408 to temporary symbol X. 

CLEAR COMMAND (C*) 

Command clears all defined breakpoints. 

Format: 


C* CR 
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Cn/CHDn 

CLEAR COMMAND (Cn) 

Command clears specific breakpoint. The value of n may be between 0 and 9. 
Format: 

CnACR 

Example: 

C3 CR 

The example causes breakpoint number 3 to be cleared. 

CHANGE MEMORY COMMAND (CH) 

Command allows specific memory locations to be given specific values. 
Format: 

CHAexpArexp|Arexp...| CR 

Examples: 

CH 100 0/10 CR 

In this example, locations 100 to 10F will be zero-filled. 

CH 200 4FFF CR 

Execution of this command puts the value 4FFF into location 200. 

CH 2000 0/10 1/10 2/10 CR 

This example shows how multiple repeat factors can be used: 
execution of this command causes locations 2000 to 200F to 
be given a value of zero, locations 2010 to 201F to be given 
a value of 1, and locations 2020 to 202F to be filled with 2's. 

DEFINE COMMAND (Dn) 

Identifies the command line within the parentheses with the number n; n 
must be a value between 0 and 9. 

Format: 

DnA(command line) CR 

Examples: 

D3 (CH 100 0) CR 

This example associates the number 3 with the command within the 
parentheses. Hereafter, each time the command E3 (see below) is 
executed, the parenthetical command will be executed and location 
100 will be zero-filled. 

This next example illustrates another use of the Dn command: 

D4 ( ) 

namely, command line 4 will be deactivated. When a disk that has 
predefined command lines from a previous execution is reused, the 
lines may be referred to without redefinition. (See the Sn command.) 
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DH/DP/DT 


DISPLAY MEMORY COMMAND (DH) 

Command causes specified memory locations to be displayed in hexadecimal 
notation either on the operator's console, or on the device specified by the lrn 
used. 

Format: 

DH|/lrn|Arexp j Arexp...£ CR 

Examples: 

DH 200 CR 

Execution of this command results in the display of the contents of 
location 200 on the operator's console. 

DH/2 200/100 CR 

Execution of this command displays the contents of locations 200 to 
2FF on the device associated with LRN 2. 

DUMP MEMORY COMMAND (DP) 

Command causes the display of (a minimum of one line) an area of memory 
starting at a specified location. Display is in hexadecimal and ASCII notations. 

Format: 

DP{/lrnfArexp|Arexp..CR 

Examples: 

DP 200 CR 

Execution of this command displays one line of memory in both hexa¬ 
decimal and ASCII, starting at location 200. 

DP/4 80/40 200/240 CR 

This command causes the contents of locations 80 to BF, and 200 to 
43F to be displayed on the device associated with LRN 4. 

DEFINE TRACE COMMAND (DT) 

Command associates the command line within the parentheses with the occur¬ 
rence of a trace trap or a BRK instruction not already defined as a breakpoint. 

Format: 

DTA(command line) CR 
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DT/En/GO/Hn 


Examples: 

DT (AR) CR 

This command causes all registers to be displayed each time a 
trace trap occurs. 

This next example illustrates another use of the DT command: 
DT ( ) 

namely, the deactivation of the defined trace command line. 
When a disk that has predefined command lines from a pre¬ 
vious execution is reused, the lines may be referred to 
without redefinition. (See the Sn command.) 


EXECUTE COMMAND (En) 

Command executes the predefined command line specified by n, a number from 
0 to 9. The En command may not be included in predefined Dn command lines; it 
is permitted in Sn and trace command lines. 

Format: 

ENACR 

Example: 

E3 CR 

GO COMMAND (GO) 

Command results in the resumption of execution on an active level after a 
breakpoint. 

Format: 

GOACR 


PRINT HEADER LINE COMMAND (Hn) 

Command causes a header line to be printed; line spacing is controlled by 
the value of n, such that when n=0, there is a skip to the head of form before 
the header line is printed; otherwise, the number of lines between 1 and 9 are 
skipped before printing. A header line may consist of any ASCII characters 
and/or expressions; expressions are preceded by a percent (%) sign. If a % sign 
is to be printed, two characters must be used (%%). A header line must end with 
a space character. 

Format: 

HnAj/lrn| a( header line) CR 
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Hn/LVLL 


Example: 

HO/2 (DUMP OF BREAKPOINT FOR LEVEL %$SA) CR 

This header will be printed on LRN 2 at the top of a new page 
as soon as the carriage return is typed. The example illustrates 
a way to document dumps. The main use of the header command is 
to document printed information related to breakpoint or trace 
trap debugging. 


LIST ALL BREAKPOINTS COMMAND (L*) 

Command lists all breakpoints. 

Format: 

L*Aj/lrn(CR 

Example: 

L* CR 

This command will cause all breakpoints to be printed on the 
operator's console. 

LINE LENGTH COMMAND (LL) 

Command specifies the line length of the console in use. The length value 
is expressed in decimal notation, and the limits are: 3CK value< 126. 

Format: 


LLAvalue CR 

Example: 

LL 72 CR 

This command signifies that the console in use has a line length 
of 72 characters. 
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Ln/P* Pn/PT/RF 


LIST BREAKPOINT COMMAND (Ln) 

Command causes the listing of a particular breakpoint that was set by a Sn 
command, and lists the command line. 

Format: 

LnA{/lrn}cR 

Example: 

L2/4 CR 

This command causes the display of the command line of breakpoint 2 
on the device associated with LRN 4. 

PRINT COMMAND (P*) 

Command causes all command lines predefined by Dn commands to be printed. 

P*)/lrn[CR 

PRINT COMMAND (Pn) 

Command causes specified command line predefined by Dn command to be 
printed. 

Format: 

Pn)/lrn(cR 

The value of n can be between 0 and 9. 

PRINT TRACE COMMAND (PT) 

Command causes a trace command line to be printed. 

Format: 

PT{/lrn}CR 


RESET FILE COMMAND (RF) 

Command resets the location of DEBUG.WORK, and prohibits commands that use 
this file from operation until another SF command is issued. 

Format: 


RF CR 
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SET BREAKPOINT COMMAND (Sn) 


Command sets a numbered breakpoint (n) at a particular location. The value 
of n can be from 0 to 9. When the breakpoint is encountered, an existing command 
line is executed, otherwise a message is displayed on the console and task ex¬ 
ecution ceases. The Online Debug Program now has the highest priority. The 
console message indicates the contents of the location counter and the active 
priority level. 

If there is a preexisting command line associated with a given breakpoint, 
the old command line must be replaced with a new one, or cleared using empty 
parentheses ( )? otherwise, the old command line will be executed. (See the 
Dn command.) 


The message format is: 

BPn $P=00XXXX $SL=00XX 


Format: 


SnAexp j(command line) | CR 

Example: 

SO 100 (DH 200/10;GO) CR 

This command will cause the display of locations 200 to 20F when 
location 100 is executed. 


SPECIFY FILE COMMAND (SF) 

Command identifies the location of DEBUG.WORK file. Since the function of 
the command is to open the work file, it should be the first command executed; 
failure to do this results in the issuing of an error message as soon as a 
command which requires the work file is used. LRN is specified in hexadecimal 
notation. 

Format: 

SFALKN CR 

Example: 

SF B CR 

This example indicates the work file to be logical resource number 

11 (decimal). 
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SL/TL/VH 


SET LEVEL COMMAND (SL) 

Command sets the current and active levels to the value of exp. The current 
level remains unchanged until another SL command is issued. The default value 
for the current level is 0. 

Format: 

SLAexp CR 

Example: 

SL C CR 

This command sets the level to 12 (decimal). 

SET TEMPORARY LEVEL COMMAND (TL) 

Command sets the temporary level to the value of exp until another SL, or 
TL command is issued, or until the end of a command line. 

Format: 

TLAexp CR 

Example: 

TL A;AR;TL B;AR CR 

This command causes all registers on levels 10 and 11 to be displayed. 

PRINT HEXADECIMAL VALUE COMMAND (VH) 

Command prints the value that is the result of the expressions used. 

Format: 

VH{/lrn^AexpjAexp...[ CR 

Examples: 

VH [100]CR 

This command causes the display of the contents of the addres found 
at location 100. 

VH .+100-M CR 

This command causes the display of the result of the computation 
defined by the last referenced memory location plus 100 (hexa¬ 
decimal) minus the value assigned to the temporary symbol M. 
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Using the Online Debugging Program 

Program testing and error correction is performed as an interactive dialog 
between the operator and the Online Debug Program. To achieve control over the 
task code being tested, the Online Debug Program is given a priority higher than 
that assigned to task code, but lower than that given to the console and printer 
used by the operator for the dialog. 

The Online Debug Program is included in your application configuration by 
using the following CLM commands: 

TSA n,m (Required if breakpoints or trace traps used.) 

EVAL ZDTLRN,TLRN 

EVAL ZDDLRN,DLRN 

ADMOD filename:ZDBG 

TASK ZDTASK,lrn,level,YACT 

TLRN - The LRN of the command terminal. 

DLRN - The LRN of the disk on which DEBUG.WORK file is located. 

See Appendix A in this manual for an explanation of the other CLM command 
parameters. 

When the configuration process is finished, the Online Debug Program lets 
you know that it is ready to accept input by sending a message to the console. 

The following example contains typical operations that might be performed 
in the course of using the Online Debug Program. 

Example: 

1. Establish header, predefine a command line, initialize a 
header variable to zero. 

HO(DUMP %M OF AREA 0) CR 

DO (HO/3;AR/3;DH/3 20/4 [8A]/1A [8BJ/1A Y/100) CR 
AS M 0 CR 

2. Set breakpoints in code under test. 

50 300 (AS M M+l) CR 

51 4A6 (AS M M+l) CR 

3. Activate level 8 and wait for breakpoints. 

AL 8 CR 

4. When the breakpoint occurs, execute predefined command 0 
and then continue. 

E0 CR 

GO CR 
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NOTE: The predefined command line in the example above (the 

DO ...) sets up commands that will display the header, 
registers, activity indicators, and the ISA's for 
levels 10 and 11. 


ADDITIONAL OPERATING NOTES FOR THE ONLINE DEBUG PROGRAM 

1. Online Debug Program can be brought to command level either 
when the console is idle, or when the ODP is producing out¬ 
put, by typing the "/" character; ODP indicates that it is 
ready by printing D? at the beginning of a line. 

2. If the DP, DH, or VH commands are producing output, and an 
I (exclamation mark) is typed, the output will be aborted. 

3. Command lines for the Sn, Dn, and DT commands may not ex¬ 
ceed 126 characters. 

4. A GO command embedded in a breakpoint command line allows 
task execution to proceed after the desired operations 
have been performed, without further operator intervention. 

5. The following rules should be observed when using breakpoint 
instructions: 

a. Breakpoints may not be set in code that will be 
executed at the Inhibit level. 

b. Breakpoints set on the following instructions must 
be cleared (Cn command) 1 before continuing execution 
(GO command): any I/O, generic (BRK), scientific, 
illegal, or LEV instruction, or any instruction with 
an illegal address syllable. 

Note that the clearing of a breakpoint becomes un¬ 
necessary if a second breakpoint command line used on 
a nonrestricted instruction reinstates the first com¬ 
mand line used on a restricted instruction, when both 
are executed repeatedly within a program loop. 

6. Note that the display, change, and dump functions apply to registers 
on the active level. The active level changes depending on the op¬ 
eration of the Online Debug Program. The active level can be con¬ 
trolled in several ways: 

a. It is set to the level defined by the SL command whenever 
console input is processed thus allowing the operator to 
access registers on the same level each time a command is 
entered from the console, regardless of the change in the 
active level due to delayed commands since the last command 
entered from the console. 

b. It is set to the level at which a breakpoint or trace trap 
occurs, thus allowing the predefined command line being 
executed to display or alter registers on its own level. 

c. It may be set temporarily with the TL command so that reg¬ 
isters of a level different from the active or console 
levels may be displayed or altered without permanent change 
to the active or console level definitions. 

d. It is set with the SL command, and this level becomes the 
console level. 

e. Active level control is designed to assume the value that will 
most probably be needed based on the ODP action in progress; 
i.e., console, breakpoint, trace trap, or temporary reference 
to a different level. 
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LOCATING LOAD MODULES 


The CLM builds data structures, as defined by its commands, and places the 
load modules immediately following the data structures in memory. Once an appli¬ 
cation is fully developed, there is no requirement to know the start address of 
load modules each time the system is loaded because it is invariant and of no 
concern to the user of the application. 


During application development, however, there is a vital need to know 
where load modules are in memory. Otherwise, the link maps of load modules 
(based at zero relocation factor) are almost useless. The start address of 
each load module can be printed on the operator's console by a utility whose 
load module name is ZXMAP. This information will be of value when debugging, 
and is displayed under the following two circumstances: 

1. Load Phase of CLM reaches the normal halt indication and the 
Map option of the CLM QUIT command was used to load ZXMAP. 

The occurrence of other indicators (e.g., multiply-defined or 
undefined symbols) is incidental. If the application's load 
modules will fit into available memory on the application de¬ 
velopment hardware configuration, and there is an operator's 
console then ZXMAP consists entirely of initialization code. 

When loaded, (as the last load module), it uses the operator's 
console channel number known to the loader and prints on the 
console two sets of information: 

a. Names of undefined symbols 

b. Names and start addresses of all load modules 
currently memory-resident 

2. Load Phase of CLM encounters loader halt, indicating insuffi¬ 
cient available memory. 

This circumstance means that the data structures plus the load 
modules for the specified application will not fit into avail¬ 
able memory. ZXMAP may now be used to print on the console a 
list of load modules that are in memory and those that are not. 
Although ZXMAP cannot be loaded by CLM since no memory is 
available, it may be loaded as a stand-alone offline program. 

The standard bootstrap procedure for offline programs should be 
used, and the ZXMAP start address (relocation factor) should 
be specified in low memory to avoid overlaying the CLM infor¬ 
mation to be printed. The recommended relocation factor for 
ZXMAP is DO. 

Another possible approach is to load ZXMAP as an ADMOD . . . 
after selected ADMOD commands of the application. This will 
produce multiple maps and you can get one indicating memory 
usage before the CLM attempts to load the module that causes 
the error halt. This module will be visible in a dump of 
the loader area of memory at HMA-3 to HMA-12. 

Figure 4-1 shows a sample console output of ZXMAP. It contains 
the hexadecimal start addresses of the application load mod¬ 
ules. FMDEMO is the load module name of the sample user 
application. To debug FMDEMO the user needs object listings of 
the modules contained in FMDEMO (e.g., FMA, FMB, FMC) and the 
link map produced when FMDEMO was created. The link map gives 
the zero-relative offsets of tags within FMDEMO. 
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ZXEX02 

*0755 

ZYFM01 

*0DF9 

FMDEMO 

*14E0 

ZIKSR 

*16DF 

ZILPT 

*183E 

ZICDR 

*18AC 

ZIDSK 

*1922 

ZXMAP 

*19CA 


Figure 4-1. Sample ZXMAP Output 


Assume that FMA, FMB, and FMC were linked in that order and 
start at relative 0, 100, 200 hexadecimal, respectively. 

To locate an instruction in memory that is in module FMB, 
add 100 plus the instruction offset within FMB to 14E0^g. 

If a load module has not been brought into memory, 

ZXMAP prints 


<load name>*0000 

For undefined symbols, ZXMAP prints 

<symbol name>*(blank) 


DEBUGGING DURING ONLINE APPLICATION DEVELOPMENT 


Monitor Points 

The system may be monitored in several different ways to verify proper se¬ 
quencing of memory and/or register contents within routines, or proper task se¬ 
quencing. Each method requires manual insertion of monitoring code, and implies 
that space exists within the system for it. 

These are ways of creating space to insert monitor points: 

• Leave space temporarily in various application modules. 

• Append monitoring points using Program Patch. 

• Use ODP 


The sophistication of the monitoring performed depends on the stage of the 
application development and testing. The monitoring routine could be a simple 
halt instruction, a conditional call to the Trace Trap Handler based on current 
variable status, or an Online Debug Program breakpoint. in each case, you may 
construct what is required at the time. Program Patch is described in the 
Utility Programs manual. 

If space is allocated in application modules, it may be used by invoking 
the Online Debug Program. 
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MANUAL CONTROL 


When single-word halt instructions are used as monitoring points, the use of 
the DO single instruction capability is convenient. The instruction word re¬ 
placed by the halt may be entered into the instruction register (DO) when the 
halt occurs, even if the full instruction occupies more than one word in memory. 
However, the halt must replace the first word of the instruction. 

For example: 

Source Line Object Code 

LAB $B2,$B4,TAG loc/ABC4 instruction word 

loc+1/0004 tag value 

ABC4 may be replaced by a halt (all zeros). When the P-register (EO) halts at 
loc+1, the instruction register (DO) may be changed back to ABC4 and execution 
continued. Since this does not change the content of loc, the halt will reoccur 
the next time the code sequence at loc is executed. 

You can use the single word halt effectively in debug phases where only one 
priority level is active at a time. If more than one level is active, you may 

use the halt at inhibit level option of the Trace Trap Handler to "freeze" the 

entire system; i.e., all priority levels including the real time clock. This 
option is invoked by a BRK generic instruction followed by a HLT instruction. 

Now use the control panel to enter step mode to examine registers. Then execute 
a single instruction before restarting program. 

Real-Time Clock (RTC) 

Some applications require the real-time clock, activated at load time. 

While the clock is turned on, the CPU is difficult to use in single instruct 
mode because the RTC is continually generating an interrupt at clock level (level 

4). In the early stages of application debugging it may be useful to turn off 

the clock to facilitate "stepping" through a code sequence without interference. 

This is easily done using the capability of executing one instruction from 
the DO register as described in the following procedure. 

To turn off the clock before starting the application, use the capabilities 
of executing one instruction from the instruction register (whose selection code 
is DO) to execute an RTCF instruction while in single instruction mode. Then 
clear the instruction register (DO), set the P-register (EO) back to CLM halt 
address and press Ready and Execute. Once the ODP is executing: 

a. Press Stop and select DO; change to 0005. 

b. Press Execute (this turns off clock) 

c. Select DO and change to 0000. 

d. Select E0 and change to CLM halt address. 

e. Press Ready and Execute. 
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Data Structures 


There are several useful hardware data structures that contain valuable in¬ 
formation for system debugging. 


Refer to Figure 4-2 to show portions of an actual memory dump which contains 
these structures. 


0010/ 0204 0000 0000 0000 0006 0004 0004 0000 

0018/ 0000 0000 0000 0000 0000 0000 0000 001E 

0020/ 0000 0000 0000 0001 0000 0000 0000 0000 


HARDWARE DEDICATED LOCATIONS 


ZEROS 


0078/ 0000 0000 0000 0000 0000 0000 3830 0000 

0080/ 0000 0000 0000 0253 0180 01A3 01B9 01CF ISA POINTERS USED BY THIS APPLICATION 

0088/ 01E5 01FF 0211 0227 0230 0253 0269 027F 


ZEROS 


0088/ 0000 0000 0000 0000 0000 0000 0000 0187 ISA POINTER FOR LEVEL 63 

OBCO 0000 0294 3FFF 02B4 0416 OOOF 136A 3FFF CLM-SUPPLIED EXECUTIVE INFORMATION 

I - CLM DATA STRUCTURES -I 


1 

01B0/ 

0000 

0000 

0000 

1240 

0500 

0005 

0000 

1 

FF00 

01B8/ 

0000 

1000 

FFFF 

0000 

07 AB 

4000 

0000 

0000 

01 CO/ 

1925 

0000 

31B0 

3ED0 

3ED3 

19D3 

19CF 

3DA4 

01C8/ 

3064 

0000 

0000 

0000 

0000 

FF00 

0000 

13C7 

0100/ 

FFFF 

0000 

07A5 

4003 

183D 

02D5 

1705 

0C31 

0108/ 

17D5 

02D7 

1799 

0018 

0000 

0000 

0000 

13C0 

01E0/ 

FFFF 

0007 

0000 

FF00 

0000 

0000 

FFFF 

0000 

01E8/ 

1 

07 AB 

4000 

0000 

0000 

183E 

0000 

0000 

0000 

1 


UNUSED INITIALIZED ISA'S 


ISA FOR LEVEL 6 (BEGINS AT LOCATION 189,.) 

1b 


0250/ 

0000 

FF00 

0000 

0000 

FFFF 

0000 

080B 

i 

4003 

0258/ 

0325 

033F 

10FD 

0682 

02F5 

062F 

0135 

0014 

0260/ 

FFFF 

803F 

0050 

0000 

0050 

1000 

0000 

FF00 

0268/ 

0000 

0000 

FFFF 

0000 

07AB 

4000 

0000 

0000 


REMAINDER OF ISA'S 


0290/ 

0000 

0000 

0000 

FF00 

J 0000 

0000 

0000 

0000 

0298/ 

0000 

0000 

0000 

0000 

0000 

0682 

0000 

0000 

02A0/ 

0000 

0000 

0000 

0000 

1 0000 

0000 

0000 

0000 

02A8/ 

0000 

0000 

0000 

0000 

0000 

0682 

0000 

0000 

02BO/ 

0000 

0000 

0000 

0000 

1 0205 

02E5 

02F5 

0305 

02B8/ 

0315 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0200/ 

0000 

02D4 

0000 

0000 1 02CC 

0000 

0000 

0000 


ISA FOR LEVEL 13 (BEGINS AT LOCATION 253 16 ) 


— SOQ TABLE 
_ EOQ TABLE 
_ LRT 

(FOUND BY USING ZXMAP, LINK MAP, AND LISTINGS 
AND CLM-SUPPLIED INFORMATION ATC0 1g ) 


Figure 4-2. 


Hardware/Executive Data Structures 


Location 10 contains the trap save area pointer. If traps have occurred, 
the trap save areas can be located using this pointer. Since CLM creates trap 
save areas to be contiguous, even unlinked TSA's may be located. 
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Locations 20 through 23 contain the level activity indicators. They may be 
examined to discover which level was running or waiting to run. In Figure 4-2, 
only level 63 (location 23, bit 15) was active. 

Location 80 and above contain the ISA pointers for the system. A minimum of 
64 locations are always reserved by CLM. Nonzero ISA pointers indicate the 
potentially-active levels in the system. The pointer in location 83 (level 3) 
is always either zero or a duplicate of another valid ISA pointer. By matching 
its contents against the others, you can discover the last level to execute on 
the inhibit level. In Figure 4-2, it was level 13 (location 8D). 

Within the ISA's for each level, the S-, P-, and B5-register entries are of 
interest. When the S-register contains the level number of the level itself, 
it was probably interrupted by a higher priority level. If it is zero, the level 
has probably not been executed. When the level number is 3, the task has termin¬ 
ated using the Task Manager. 

The P- and B5-registers may prove useful to determine the starting address 
of a task or Task Manager entry point. 

Device driver ISA's indicate whether the device interrupt has ever occurred. 
The device places information in the ISA upon interrupt. Figure 4-2 indicates a 
13C7 at location 1CF. This is decoded as: 

13C0 channel number 
07 device level assignment 

The level number is the last 6 bits of the 16-bit word. 

Software data structures used by the Task Manager and/or device drivers 
may best be located by finding a reference to them in Honeywell listings, locating 
those references in the memory dump, and then examining the structures. The in¬ 
formation supplied by the CLM immediately after the ISA pointers may be used to 
find SOQ,EOQ, and LRT (and thereby RCT's) that may be of interest. CLM also 
provides a pointer to ZXcccc in the Clock Manager module. This is the location 
immediately before the first of four clock queue data structures. Once these 
structures are located, enqueued request blocks may be examined and clock timer 
blocks of drivers analyzed. 

Trace History 

When using the Online Debug Program with disk-stored command lines that 
execute upon encountering a trap or a breakpoint, a trace history may be main¬ 
tained on a line printer. Otherwise, use the Trace Trap Handler. 
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Handling Load Errors 


When the CLM produces a load error (1695) indicating insufficient memory 
for loading the application, there may be ways to rearrange load modules to 
solve the problem. 

1. Be certain that load modules with large load-time initial¬ 
ization requirements are loaded first (e.g., communications 
or File Manager) so that maximum advantage is taken of the 
possibility of overlaying CLM initialization by permanent 
load modules. Clearly, being unable to load a module because 
the initialization code is too large can be corrected by 
placing I/O drivers (DEVICE commands) or the Executive 

load modules (ADMOD commands) near the end of the load module 
commands. 

2. Be certain that ADMOD commands associated with floatable 
overlays are also ahead of other modules that do not have 
overlays or initialization code. Recall that floatable 
overlays need occupy no permanent memory space outside the 
CLM residue. 

3. Consider recoding nonfloatable overlays as floatable to make 
better use of CLM residue that can't be used during loading. 

As an extreme solution for an 8K environment, the bulk of 
the application could be coded as floatable and called into 
residue space by its root, which is designed to do nothing 
more than that. 

4. Double check configuration commands to make sure that the 
minimum amount of space required is used for data structures. 
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APPENDIX A 


CONFIGURATION LOAD MANAGER COMMANDS 


Commands entered through the command input stream direct the operation of 
the Configuration Load Manager (CLM). Using these commands, you can define the 
environment in which the application is to be run, and specify the modules to 
be loaded. The configuration commands identify the load module, specify the 
memory requirements, system services, and peripheral complement to be used; set 
up internal data structures, and establish trap handling procedures. 


Table A-l summarizes the CLM commands and functions. Individual commands 
are described in detail later in the section. 


Table A-l. Summary of CLM Commands and Command Functions 


Command Category 

Commands 

Functions 

System Configuration 

SYS, OIM, TSA, TRAP, 
CLOCK, DATE 

Set up data structures in main 
memory; define application en¬ 
vironment. 

Load Configuration 

ADMOD, ELOC, EVAL 

Constructs a load module list 
consisting of all modules re¬ 
quired by the application; list 
consists of file names with sub¬ 
lists of module names; module 
names should be unique; the 
order of modules in the list is 
critical when they are loaded 
from a sequential device; per¬ 
mit symbol definition. 

Task 

DEVICE, TASK, ATLRN, 
EQLRN 

Explicitly specify relationships 
among tasks, devices, logical 
resource numbers, and interrupt 
levels; cause data structures 
to be built. 

Buffer Management 3 

BUFSPACE 

Defines buffer pools and re¬ 
lated tables that are used by 
the Buffer Manager. 

File Management 3 

FILMGR, DEVFILE, FMDISK, 
ATFILE 

Provide information by which 

CLM builds the data structures 
used by File Manager to support 
a centralized file access capa¬ 
bility. 
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Table A-l (cont). Summary of CLM Commands and Command Functions 


Command Category 

Commands 

Functions 

CLM Control 

IOS, *(comment), QUIT 

Direct the general actions of 

CLM; provide documentary infor¬ 
mation within the command input 
stream. 

a 

Communications 

COMM, TTY, VIP, BSC, 
MODEM, LTPDEF, LTPn, 
STATION 

Explicitly define each communi¬ 
cations device; define attri¬ 
butes of communications appli¬ 
cation; cause data structures 
to be built; analogous to DEVICE 
command for peripheral devices; 
specify relationships among 
tasks, devices, logical resource 
numbers, and interrupt levels. 

CLM Extensions 

LACT, ELACT, IOS 

Load the optional extensions to 
CLM so that file management, 
buffer management and communi¬ 
cations functions can be con¬ 
figured. 

a Optional extensions that are added to the basic CLM through the use of the 

LACT and ELACT commands interpret the information supplied by commands in 
these groups. 


COMMAND FORMAT 

The CLM accepts commands through the designated command input device. 
Each command is a separate line of input, consisting of a string of up to 72 
ASCII characters. If the command input stream is entered through an operator 
console device, each command is terminated by a carriage return. 


A command line contains a CLM command, including its operands and 
(optionally) comments. The format of a CLM command is shown below. In this 
example, lowercase characters indicate items that are to be replaced by actual 
values. Operands shown within brackets are optional; default values are used 
if these operands are not specified. 

NOTE: The command mnemonic itself need not be specified if all 

the operands of the command are optional and if the de¬ 
fault values of those operands are to be used. 

position Position 

1_72 

mnemonicAoperandl [,...,operandn][Acomments] 


The command mnemonic, consisting of one or more ASCII characters, specifies 
the action to be performed. The command mnemonic is separated from its operands 
by a single space character (indicated by a delta (A) character). Commas 
separate individual operands and a space or carriage return terminates the 
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operand set. Omitted operands are indicated by consecutive commas; trailing 
commas are not required. Comments can follow the operand field, separated from 
the operands by one or more space characters. The order of operands in the 
command line is significant. 

The operands associated with the CLM commands can be strings of ASCII 
characters, or decimal or hexadecimal integers. An ASCII operand begins with 
an alphabetic character or with an apostrophe character and ends with a comma, 
space, carriage return, or apostrophe character or when the maximum string 
length of 64 characters is reached. For purposes of specifying a numeric 
string, as opposed to a decimal number, the string must be bracketed by 
apostrophes. ASCII strings are stored in memory in an even number of bytes, 
left-justified on a word boundary. 

An integer used as a command operand is unsigned and can be a single-word 
decimal or hexadecimal number or a double-word hexadecimal number. The follow¬ 
ing conventions are used to represent integers in an operand string: 

ddddd - Single-word decimal; d is a digit in the range 0 

UUJ. WUVjli -/ 

X'hhhh' - Single-word hexadecimal; h is a digit in the range 
0 through F 

D'hhhhhhhh' - Double-word hexadecimal; h is a digit in the range 
0 through F 

In memory, an integer is right-justified on a word boundary, and left- 
filled with zeros. An operand that specifies an address must be a double- 
word hexadecimal integer. 

NOTE: In the following description of CLM commands, the term 

"integer" refers to a single-word integer unless other¬ 
wise noted. 

INPUT DEVICES FOR CLM 

Command input to CLM can be submitted on cards, on diskette, or through 
an operator's console (a KSR device). During the execution of CLM, the command 
input device can be changed by the IOS command. (See "IOS Command" later in 
this appendix.) 

Under the direction of these commands, CLM accepts load modules on diskette 
files, loads these modules into memory, and initiates the execution of the 
application. 

The diskette file and member names of the command input to CLM must be 
CLMCI when the Command Processor is not in use. 
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ADMOD/ATFILE 


ADMOD Command (Add Load Module) 

The ADMOD command adds a new module name to the end of the load module 
list, and specifies that this module is to be loaded during the loading phase. 
The order of ADMOD commands determines the order in which the load modules are 
loaded. 

NOTE: The fact that new module names are added to the end of 

the load module list can be significant when loading is 
to be done from a sequential device, since only one pass 
is made over the medium. 

The format of the ADMOD command is shown below. 

ADMODAfile-name:member-name[,X'channel'] 

ADMOD - Command mnemonic 

file-name - The name of the file in which the load module resides. 

member-name - The name of the load module. This load module is a 
member of the file whose name is specified in the file-name 
element. 

channel - A hexadecimal integer giving the channel number of the 
device from which the specified file/module is to be loaded. 

If this operand is omitted, the channel number of the device 
from which the Configuration Load Manager was loaded is used. 

The ADMOD command with the same file-name/member-name as a previous ADMOD 
command causes the channel number to be updated with the new one. This is 
useful if a driver module must be loaded from a different channel than the 
default channel specified in the implicit ADMOD statement that is issued with 
the following commands: DEVICE, COMM, TTY, VIP and BSC. 

The explicit ADMOD command to alter parameters present in an implicitly 
invoked ADMOD command is issued after the command that caused the implicit 
command to be issued. 

ATFILE Command (Attach File) 

The ATFILE command relates a logical file number to a file. The format 
of the command is shown below. 

ATFILEAlfn,path-name 
ATFILE - Command mnemonic. 

lfn - The logical file number used to refer to the file once 
that file has been opened. This value must not exceed 
the max-lfn specified in the FILMGR command. 
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ATFILEATLRN 


path-name - A string of ASCII characters specifying the directory 

path required to reach the indicated file. The path for 
diskette begins in the directory of mounted volumes. 

The path-name has the form: system or user ( ) iden¬ 
tifier volume-name>file-name. The greater than symbol 
(>) must be used to separate the volume-name from the 
file-name. A volume-name may be up to six characters 
in length; a file-name may be up to 12 characters long. 


A nondiskette path-name has the same form as a diskette file-name; i.e., 
1 to 12 characters without the greater than (>) sign preceding it. Refer to 
the Executive and Input/Output manual, "Glossary of File Manager Terms" for 
more detail. 


ATLRN Command (Attach LRN) 

The ATLRN Command relates a logical resource number (LRN) to a physical 
priority level. The ATLRN command assumes that all levels within the specified 
range that are not explicitly defined in DEVICE commands are available for use 
by nondevice tasks. 

LRN's not explicitly assigned a level by a DEVICE, TASK, or ATLRN command, 
remain unassigned. Attempts to use an unassigned LRN result in a "request 
task" error. 


The ATLRN command can also be used to relate additional LRN's to a given 
level number. 


The format of the ATLRN command is shown below. 

ATLRNAlrn,level[,rct-size] 

ATLRN - Command mnemonic. 

Irn - The logical resource number, no greater than the value of 
the hilrn operand of the SYS command. 

level - The priority level at which the task requested by the 
specified logical resource number will execute. The 
value of the level operand cannot be less than 5 nor 
greater than the value specified as the lolevel of the 
SYS command. 

rct-size - An integer that gives the size, in words, of the RCT for 
the associated LRN. The default value is one word. If 
the rct-size parameter is omitted, the default value will 
be assumed, unless the level parameter is the same as 
that in a previous DEVICE, TASK, TTY, VIP, BSC, LTP, 
STATION, or ATLRN command; in this case, no new RCT is 
created, the lrn becomes a synonym for the lrn in the 
previous command having the same level parameter value. 
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The following rules apply to an ATLRN command: 

• An ATLRN command with an rct-size parameter always produces an 
RCT of that size; its LRN is never a synonym. 

• The lrn of an ATLRN command that has no rct-size parameter is 
synonymous with the lrn of the immediately previous TASK, DEVICE, 
TTY, VIP, BSC, LTP, STATION, or ATLRN command having the same 
level parameter value. 

• The default value of the rct-size parameter is one word. 


The use of the ATLRN command allows you to relate RCT's of different 
sizes to the same priority level. Consider the following set of commands: 

DEVICE CDR,1,6,X'0580' 

ATLRN 2,6 
ATLRN 3,6,19 
ATLRN 4,6,37 
ATLRN 5,6 

The RCT constructed as a result of a DEVICE command is 16 words long; LRN 2 
is a synonym for LRN 1 and refers to the same RCT. LRN's 3 and 4 are unique, 
and refer to RCT's of 19 and 37 words, respectively. LRN 5 is a synonym for 
LRN 4, and refers to the same RCT. Priority level 6 then, has three RCT's 
associated with it: one of 16, one of 19, and one of 37 words. 


BSC 2780 Command 

This command identifies each binary synchronous communications line in¬ 
cluded in the system. The format of the BSC command is: 

BSCAlrn,level,channel[,label][,modem][,primary/secondary][,character-set] 


BSC - Command mnemonic. 

lrn - The logical resource number by which the device is requested. 
It must be less than or equal to the hilrn parameter of the 
SYS command. 

level - The priority level at which the driver for the device will 
execute. Must be less than or equal to the lolevel parameter 
of the SYS command; it may be the same as other communications 
devices, but must be different from the level specified in the 
COMM command, and from the levels for noncommunications tasks 
and devices. 

channel - The channel number of the device. 

label - A label, assumed to be a location definition, which must be 
defined in a load module. This label is the entry point of 
the attention subroutine. The default is null. 

modem - A number specifying the type of data set. Possible values 
are: 

0 - Direct connect. 

1 - Bell Ixx-type modem (103A,113F,etc). Both data-set-ready 
and carrier-detect signals are needed for a connection; 
lack of both signals is a disconnection. 
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2 - Bell 2xx-type modem (201A,201C,208A / etc). The data-set- 

ready signal is needed for a connection; lack of this 
signal is disconnection. 

3 or greater - User-defined modem type (see MODEM command). 

The default value is modem type 2. 

primary/secondary - Values may be specified as P or S; indicates 
whether this is the primary or secondary endpoint of the 
transmission. A primary endpoint has higher priority when 
sending data. 

character set - One of the following may be specified: 

AS - ASCII (default) 

EB - EBCDIC 

TE - Transparent EBCDIC 


When this command is processed, an implicit ADMOD command is issued to 
include the BSC line-type processor (ZQPBSC) in the load list. 



BUFSPACE Command (Pool Definitions) 

The BUFSPACE command defines contiguous areas of memory (called "blocks") 
to be used as buffer areas. Blocks of uniform size are linked into a pool. 

Each pool is controlled by a pool parameter block (PPB), which describes the 
location of the first block in the pool and the size of blocks in this pool. 

A set of PPB's,'in order by block size, forms a pool parameter table (PPT). 

The information contained in the PPT is required if the Buffer Manager function 
of the Executive is used. The BUFSPACE command can be used to: 

• Assign a label to the start of the PPT 

• Specify the size of each block and the number of blocks in each 
pool 

• (Optionally) Designate a predefined label in an existing load 
module as the start of the memory area containing the buffer 
pools. Alternatively, buffers are created in the residual mem¬ 
ory area between the end of the last load module and the high 
memory address specified in the SYS command. 

The BUFSPACE command defines one PPT and its associated buffer pools. The 
CLM arbitrarily creates the PPT in nondedicated memory and defines the value 
of the ppt-label parameter as the start of the PPT. 

The format of the BUFSPACE command is shown below. 

BUFSPACEAppt-label,[space-name],size,number[,size,number,...] 
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ppt-label - The label assigned to the first word of the pool parameter 
table. 

space-name - The label of the beginning of a contiguous area in main 
memory, large enough to contain all the pools defined by the 
succeeding operands in this command. If this operand is omitted, 
the buffers will be built in residual main memory space, between 
the end of the last load module and the high memory address. 

size,number - A pair of integers specifying the size (in words) of 

each block and the number of blocks in one buffer pool. As many 
size, number operand pairs as are needed can be specified. 


If the entire BUFSPACE command cannot be included on one line, additional 
BUFSPACE commands may be issued having the same ppt-label, a null space-name 
operand, and additional size, number operand pairs. 


An operand pair with the same size parameter as a previous one (the same 
ppt-label), causes the new number to replace the old one. 


The same space-name in an additional BUFSPACE command as in a previous 
one results in an error condition. 


A BUFSPACE command with a nonnull space-name, and a ppt-label the same as 
a previous one, replaces the old space-name with the new one. 


CLOCK Command (System Clock) 


The CLOCK command specifies the line frequency used to drive the system 
clock, and the period between clock-generated interrupts (i.e., the timeout 
interval). The format of the CLOCK command is: 


CLOCKA[hz],[scan-cycle] 


CLOCK - Command mnemonic. 

hz - Line frequency. Possible values are 50 to 60. 

The default value is 60 (U.S. standard). 

scan-cycle - The time, in milliseconds, between periodic real¬ 
time clock-generated interrupts. The default 
value is 50 milliseconds. The following lists show 
the possible values of the scan-cycle for both line 
frequencies: 

50-Hz line 60-Hz line 

(milliseconds) (milliseconds) 


10 

8 

20 

16 

50 

25 

100 

33 


50 


100 
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COMM 


COMM (Communications System Command) 

This command specifies the interrupt priority level for all communications 
devices. This level should be higher than all other devices and tasks, the 
recommended level is 5. The format of the command is: 

COMMAlevel 


COMM - Command mnemonic. 

level - The priority level used as an interrupt level for all 
communications devices. Must be greater than or equal 
to 5, and less than or equal to the lolevel parameter 
of the SYS command, and must be unique. The COMM com¬ 
mand must precede all other CLM communications commands. 


When this command is processed, two implicit ADMOD commands are issued: 
one for the Communications Supervisor, and one for the MLCP Driver. The de¬ 
fault channel number (from which the CLM was loaded) is assumed. If necessary, 
explicit ADMOD commands, issued after the command that caused the implicit 
command to be issued, can be used to change the channel number. The implicit 
commands are: 

ADMOD CLMCOMM:ZQEXEC (For the Communications Supervisor) 

ADMOD CLMCOMM:ZQMLON (For the MLCP Driver) 


DATE Command (Date and Time) 


The DATE command specifies the current date and time. The format is: 

DATEA[ 1 yymmdd 1 ] [, 1 time 1 ] 

DATE - Command mnemonic. 

yymmdd - An ASCII numeric string providing the current year, month, 
and date. If this operand is omitted, the default value 
is null. 

time - An ASCII numeric string providing the time of day, in the 
format hhmm, where hh is the hour of the day (an integer 
in the range 00 to 23), and mm is the minute of the hour 
(an integer in the range 00 to 59). If this operand is 
omitted, the default value is null. 
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DEVFILE Command (File Management Devices) 


The DEVFILE command identifies the nondisk devices that can be used by the 
File Manager. For any given device, the DEVFILE command must be issued after 
the corresponding DEVICE, TTY, VIP, or BSC command that defines its device 
type and logical resource number. The format of the DEVFILE command is shown 
below. 


DEVFILEAdevice-name,lrn,file-name[,double][,share][,rec-size] 
DEVFILE - Command mnemonic. 

device-name - A string of ASCII characters identifying the device. 
Possible values for the DEVFILE (column 2, below) are: 



DEVFILE 

DEVICE 

Device Type 

Command 

Command 

KSR - input and output 

KSR 

KSR 

KSR - input only 

KSI 

KSR 

KSR - output only 

KSO 

KSR 

ASR - keyboard input/output 

ASR 

ASR 

ASR - keyboard input only 

AS I 

ASR 

ASR - keyboard output only 

ASO 

ASR 

ASR - paper tape reader 

TTR 

ASR 

ASR - paper tape punch 

TTP 

ASR 

Line printer 

LPT 

LPT 

Serial printer 

SPT 

SPT 

Card reader 

CDR 

CDR 

Diskette 

(See FMDISK) 

DSK 

Cartridge disk (removable) 

(see FMDISK) 

RCD 

Cartridge disk (fixed) 

(See FMDISK) 

FCD 

TTY - input and output 

TTY ) 


TTY - input only 

TTY I > 

(See TTY command) 

TTY - output only 

TTYO ) 


VIP - input and output 

VIP ) 


VIP - input only 

VIPI > 

(see VIP command) 

VIP - output only 

vipo) 


BSC - input and output 

BSC 

(see BSC command) 


Note that the corresponding device-name (column 3, above) must have 

appeared in a previous DEVICE, TTY, VIP or BSC command. 

lrn - Logical resource number by which the device is requested. The 
value of this operand must not exceed the value of the hilrn 
operand specified in the SYS command. The operand must have 
appeared in a previous DEVICE, TTY, VIP or BSC command. 

file-name - A string of up to 12 ASCII characters specifying the 

name by which the file (device) is identified within the appli¬ 
cation. 

double - If the ASCII character D is specified for this operand, all 
reads and writes to this file will be double buffered. If the 
operand is omitted, file reads and writes are not double buffered. 
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share - If the ASCII character S is specified for this operand, the 
device can be shared. If the operand is omitted, the device 
cannot be shared. 

rec-size - The maximum record size in bytes for the device file 

described in this command. The default (decimal) values for 
individual devices are: 


KSR/ASR/TTY 

72 

ASR (read or punch) 

32,767 

VIP (input and output) 

32,767 

VIP (input or output only) 

80 

BSC (input and output) 

32,767 

Line printer 

137 

Serial printer 

133 

Card reader 

80 


NOTES: 1. The "double" and "share" parameters are mutually 

exclusive, you cannot use double buffering with 
a shared file. 


2. A file cannot be bidirectional and double buffered. 

3. Double buffering should be used in conjunction with 
the following device-name parameters: KSI, KSO, 

TTYI, TTYO, VIPI and VIPO. 


DEVICE Command (I/O Device Task) 

Each device to be used in the application must be explicitly defined in 
a DEVICE command. In addition, the DEVICE command implicitly defines the load 
module for the driver. The device-type operand is a generic name - there may 
be more than one device of the same type in the application; e.g., two diskettes. 
The level and channel operands, however, must be unique for each device. De¬ 
vice levels usually occupy a higher priority than task levels. The lrn 
operand specifies the logical resource number for the device. The lrn by which 
a device is requested need not be unique, but if a device is requested by more 
than one lrn, the ATLRN command must be used to relate these additional lrn's 
to the single level for that device. 

Specifying the same device-type and lrn operand values in more than one 
DEVICE command causes the previous DEVICE command to be updated with the new 
level and channel operand values. 

The format of the DEVICE command is shown below. 

DEVICEAdevice-type,lrn,level,channel[,label] 
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DEVICE - Command mnemonic. 


device-type - A string of ASCII characters identifying the type of 
device. Possible values and associated devices are shown be¬ 
low. 


Device Type 


Operand Value Driver Name 


KSR 

ASR 

Line Printer 
Serial Printer 
Card Reader 
Diskette 

Cartridge disk FCD 
Cartridge disk RCD 


KSR 

ZIKSR 

ASR 

ZIASR 

LPT 

ZILPT 

SPT 

ZILPT 

CDR 

ZICDR 

DSK 

ZIDSK 

(fixed) 

ZICDSK 

(removable) 

ZICDSK 


lrn -The logical resource number by which the device is requested. 

The value of this operand must be an integer that is less than 
or equal to the hilrn value specified in the SYS command. 

level - The priority level at which the driver task for the device 
will execute. The value of the level operand cannot be less 
than 5 nor greater than the value specified as the lolevel para¬ 
meter of the SYS command. 

channel - The channel number of the device. 

label - The label parameter may be either an ASCII value (location 
definition), or an integer (reference LRN) that is the lrn 
parameter of a previous DEVICE command. When the label para¬ 
meter is given an ASCII value, the value must be defined in a 
load module. The address of the label is stored as the first 
entry of the device-specific words in the device resource con¬ 
trol table (see the Executive and Input/Output manual). This 
parameter can be used by the drivers as needed, except that 
when it appears in a DEVICE command describing a KSR or an ASR, 
it must be the entry point of the attention subroutine. The 
default label for LRN 0 (operator's console) is ZIATTN, which 
is defined in the Executive load module. The default for other 
LRN 1 s is null. 

When the label parameter is used as a reference LRN (i.e., the 
value is identical to the LRN value of a previous DEVICE 
command), the location of the RCT for the previously defined 
device is stored as the first entry of the device-specific 
words in the RCT for the currently defined device. Conversely, 
the location of the RCT for the currently defined device is stored 
in the corresponding position in the RCT of the previously defined 
device. DEVICE commands specifying removable and fixed cartridge 
disk devices must cross-reference each other in this manner. 

The following pair of DEVICE commands illustrates a valid use 
of the label parameter as a reference LRN: 

DEVICE FCD,6,10,X'1280' 

DEVICE RCD,9,10,X'1280',6 
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The following rules apply to the use of the label parameter as a reference 

LRN: 

• The first DEVICE command of a related pair may not have a reference 
LRN to another DEVICE command; result is an error. 

• The level and channel parameters of a DEVICE command that has a 
reference LRN must be the same as those in the related DEVICE com¬ 
mand. 

• Given a related pair of DEVICE commands, the reference LRN must 
be the same as the LRN in the related DEVICE command. 


An implicit ADMOD command for the driver load module of the form: 

ADMOD CLMFILE:<driver-name> 

is issued with each DEVICE command. The default channel number is assumed. If 
the default channel number cannot be used, an explicit ADMOD command having the 
file-name:module-name but a new channel number can be used to change the 
channel number. (See the ADMOD command.) 

An implicit TASK command of the form: 

TASK start-address(of the device),lrn,level 
is also issued with each DEVICE command. 


ELACT Command (End Load Action) 

The ELACT command indicates that all interpretive modules have been in¬ 
cluded, and that all commands submitted to the CLM can be processed. The 
format of the ELACT command is: 

ELACT 


ELACT - Command mnemonic. 


NOTE: Prior to the processing of the ELACT command, only the IOS, 

LACT, and ELACT will be recognized as valid commands, the 
submission of any other command will result in an error 
condition. Once this command is processed, all other com¬ 
mands will be accepted, and the IOS, LACT, and ELACT commands 
will be invalid. 


The ELACT command must be issued even if no optional modules are to be 
added to CLM. 
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ELOCEQLRNEVAL 


ELOC Command (Define Address Symbol) 

The ELOC command defines a symbolic name as an absolute address. The 
definition is stored in the symbol table, and redefinition is not allowed. 

The symbolic name may be referred to in the loading process. The format of 
the ELOC command is shown below. 

ELOCAsymbol,D 1 absolute-address 1 
ELOC - Command mnemonic. 

symbol - One through six ASCII characters specifying the symbolic 
name to be assigned. 

absolute-address - The double-word hexadecimal integer specifying 
the absolute address that is the definition of the symbol. 

EQLRN Command (Equate LRN's) 

The EQLRN command provides for the definition of LRN synonyms. The format 

is: 

EQLRNAnew-lrn,old-lrn 
EQLRN - Command mnemonic. 

new-lrn - A integer, no greater than the value of the hilrn parameter 
of the SYS command, that is to be equated to a previous LRN. 

old-lrn - The value of a previously assigned LRN for which a synonym 
is being provided. 

EVAL Command (Define Value Symbol) 

The EVAL command defines a symbolic name as a value. The definition is 
stored in the symbol table, and redefinition is not allowed. The symbolic name 
may be referred to during the loading process. The format of the EVAL command 
is shown below. 

EVALAsymbol,value 

EVAL - Command mnemonic. 

symbol - One through six ASCII characters specifying the symbolic 
name being defined. 

value - A single-word integer whose value becomes the definition 
of the symbol. 
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FILMGR/FMDISK/IOS 


FILMGR Command (File Manager) 

The FILMGR command defines the general File Manager variables. This 
command must precede any other file management commands. The format of the 
FILMGR command is shown below. 

FILMGRA[max-lfn][,concurrentcalls][,concurrent opens] 


FILMGR - Command mnemonic. 

max-lfn - A value j<255 representing the highest logical file number 
(LFN) permitted in the application. The LFN is the value used 
to refer to a file once that file has been opened. The default 
value of this operand is 15. 

concurrent calls - The number of concurrent calls to the File Manager. 
This number must be an integer greater than zero. The default 
value is 4. 

NOTE: Each task can have only one call to the File Manager at 

a time, but a number of tasks can have one call each at 
a given point in time. 

concurrent opens - The number of concurrently open files. This number 
must be an integer greater than zero. The default value is 8. 


FMDISK Command (File Management Disk) 

The FMDISK command identifies the disk devices available to the File 
Manager. The format of the FMDISK command is shown below. 

FMDISKAdisk-type,Irn 

FMDISK - Command mnemonic. 
disk-type - Specifies the disk device. 

DSK - Diskette 

RCD - Removable cartridge disk 
FCD - Fixed cartridge disk 

Irn - The logical resource number by which the device is re¬ 
quested. The value of this operand must not exceed the 
value of the hilrn operand specified in the SYS command. 


IQS Command (I/O Stream) 

Using the IOS command, you can change the command input stream from one 
device to another. The format of the IOS command is shown below. 

IOSACI$,device,X 1 channel 1 [,member-name] 


A-15 


AU49 



IOS - Command mnemonic. 

CI$ - The name of the command input stream. 

device - A string of ASCII characters designating the new command 
input device. Possible values are: device mnemonics ($CDR or 
$KSR) or a disk file-name. 

channel - A hexadecimal integer specifying the channel number of the 
new command input device. 

member-name - The member name of the command input list on a disk 

device. The file in which this member resides is the file-name 
parameter. If the parameter is omitted, CLMCI is assumed. 


LACT Command (Load Action) 

The LACT command identifies a load module to be added to CLM in order to 
provide interpretation of one of the supplementary command groups. One LACT 
command must be included for each set of command group extentions required in 
the configuration. The format of the LACT command is: 

LACTAfile-name:module-name[,X'channel'][,waid][,overlay] 


LACT - Command mnemonic. 

file-name - The name of the file in which the interpretive modules 
for the particular command group reside. 

member-name - The member name of the load module that provides the 
interpretive routines for the particular command group. 

channel - The channel number (hexadecimal) of the device from which 
the load module is to be loaded. The default value is the 
channel from which the CLM was loaded. 

waid - The identification number of the work area for this module. 

If this number is omitted, the work area is not to be shared; 
if the number is the same as that supplied in the LACT command 
for another interpretive module, the work area can be shared. 

overlay - The letter 0 indicates that the interpretive modules spe¬ 
cified in this command are to be treated as overlays during the 
execution of CLM; if the parameter is omitted, all modules are 
resident in main memory during CLM operation. The parameter 
must be coded when HMA is 1FFF (8K). 


LTPDEF (Command (LTP Definition) 

This command specifies the size of the communications tables that the 
user-written LTP requires. The command is optional, but if used, must pre¬ 
cede the LTPn command that refers to it. The format is: 

LTPDEFAn,channel-table-size,station-table-size 

LTPDEF - Command mnemonic. 

n - Specifies which LTP is being defined; n is a number from 0 to 3. 
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channel-table-size - Specifies the number of words needed for the 
channel table and the CQB's. The default value is 32 words. 

station-table-size - Specifies the number of words needed for this 
LTP's station table (RCT). The default value is 7 words. 


LTPn Command 

This command specifies the characteristics of a nonstandard communi¬ 
cations device. For each device driven by a user-written LTP, this command 
must be issued. The format of the command is: 

LTPAlrn,level,channel[,label][,modem][,speed][,FDX/HDR][,LTP-specific-word] 


LTPn - Command mnemonic. There may be up to four user-written LTP's 
included in a configuration. The mnemonics could be: LTPO, 

LTP1, LTP2, or LTP3, depending on which user-written LTP is 
being defined. CLM saves the number in the channel table for 
the device for use by the LTP's initialization code. 

lrn - Specifies the logical resource number by which the device is 
requested; must be less than or equal to the hilrn parameter 
of the SYS command. 

level - The priority level at which the driver for the device will 
execute. Must be less than or equal to the lolevel parameter 
of the SYS command; it may be the same as other communications 
devices, but must be different from the level parameter in the 
COMM command, and from the levels specified for noncommunica¬ 
tions tasks and devices. 

channel - The channel number of the device. 

label - A label, assumed to be a location definition, which must be 
defined in a load module. This label is the entry point of the 
attention subroutine. The default label for LRN 0 (operator's 
console) is ZIATTN, which is defined in the executive load module. 
The default for other LRN's is null. 

modem - A number specifying the type of data set. Possible values 

are: 

0 - direct connect 

1 - Bell lxx-type modem (103A,113F, etc.) Both data-set-ready 

and carrier-detect signals are needed for a connection; 
lack of both signals is a disconnection. 

2 - Bell 2xx-type modem (201A,201C,208A, etc.) The data-set- 

ready signal is needed for a connection; lack of this signal 
is a disconnection. 

3 or greater - User-defined modem type. (See MODEM command.) 

The default value is modem type 2. 

NOTE: If the line is direct connect and asynchronous, modem 

type 2 must be specified; if the line is direct connect 
and synchronous, specify modem type 0. 

speed - The data rate in bits per second. The default value is zero, 
and signifies a synchronous line. One of the following values 
must be specified for an asynchronous line: 


50 

300 

2400 

75 

600 

3600 

110 

900 

4800 

134.5 

1200 

7200 

150 

1800 

9600 
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FDX/HDX - Specifies whether the procedure is full or half duplex. 

If it is full duplex (FDX), two channel tables will be assigned. 
The default value is HDX, 

LTP-specific-word - A word containing user-defined information to 
be passed to the LTP via the station table at offset ZQSSTS. 

The default is zero. 

NOTES: 1. An LTPDEF command must precede its corresponding LTPn 

command unless default values are to be taken for the 
channel and station table sizes. 

2. Each LTP load module must be added to the load module 
list constructed by CLM in the usual way; i.e., by 
being identified in an ADMOD command. 

MODEM 


MODEM Definition Command 


This command is used to define an nonstandard modem type. (See the MLCP 
Programmer's Reference manual for details about contents of the line control 
tables.) The information provided in this command is used to test entries in 
the LCT for the device to verify a connection or a disconnection. The format 
of the MODEM command is: 

MODEMAtype-number,connection-AND-mask,connection-XOR-mask, 

disconnection-AND-mask,disconnection-XOR-mask,data-set- 
control 

MODEM - Command mnemonic 

type-number - An integer from 3 to 15 that is assigned to this modem 
definition and may then be used in a communications device com¬ 
mand. 

connection-AND-mask - A 2-digit hexadecimal number whose value deter¬ 
mines which bits of LCT entries 14 (receive channel data set 
status) and 46 (transmit channel data set status) will be examined 
when a connect request is processed. 

connection-XOR-mask - A 2-digit hexadecimal number whose value spe¬ 
cifies which bits of LCT entries 14 and 46 must be on for a 
connection 

disconnection-AND-mask - A 2-digit hexadecimal number whose value de¬ 
termines which bits of LCT entries 14 and 46 will be examined 
when a disconnect request is processed, or when a test for the 
occurrence of a disconnect is made. 

disconnection-XOR-mask - A 2-digit hexadecimal number whose value de¬ 
termines which bits of LCT entires 14 and 46 must be on for a 
disconnection. (Entries 14 and 46 of the LCT are the data set 
status for the receive and transmit channels, respectively.) 

data-set-control - A 2-digit hexadecimal number placed in entry 

number 20 of the LCT and line register 2 (LR2) of the communi¬ 
cation line adapter (CLA) when a line is to be connected. 

NOTES: 1. To test for a successful connection , entries 14 and 46 

of the LCT are first subjected to a logical AND opera¬ 
tion against the (user-supplied) connection-AND-mask; 
then a logical exclusive OR operation is performed on 
the result of the first operation, against the (user- 
supplied) connection-XOR-mask. If the result is zero, 
a connection has been established. 
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2. To test for a disconnection , the same operations are 
carried out using the analogous disconnection masks. 

A zero result indicates a disconnection. 

3. The following table shows the mask and data set control 
values for the standard, CLM-recognized modem types: 


Modem 

Type 

Connection Masks 

Disconnection Masks 

Data Set 

Type 

Number 

AND 

XOR 

AND 

XOR 

Control 

Direct 

0 

X" 80' 

X' 80 ' 

o 

CO 

~X 

X'00' 

X' 88 ' 

Connect 







Bell lxx 

1 

X'AO ' 

X'AO ' 

X'AO' 

X' 00 ' 

X' 80 ' 

Bell 2xx 

2 

X' 8 0 ' 

X' 8 0 ' 

X ' 8 0 ' 

X'00' 

X' 80' 


OIM 

OIM Command (Operator Interface Manager Definition) 

The OIM command defines the lrn and level required by the Operator Inter¬ 
face Manager. This command must be present, or an initialization error will 
occur during the loading of the Executive load module. The format of the OIM 
command is: 

OIMAlrn,level 

OIM - Command mnemonic. 

lrn - The logical resource number reserved for use by the Operator 
Interface Manager. The value is an integer that is less than 
or equal to the value of the hilrn parameter in the SYS com¬ 
mand. 

level - The priority level at which the Operator Interface Manager 
operates. The value cannot be less than 5 nor greater than 
the lolevel parameter of the SYS command. 

QUIT 

QUIT Command (Initiate Loading) 

The QUIT command is the last configuration command in the command input 
stream. When this command is encountered, the CLM stops reading commands from 
the command input file and initiates the loading phase. As a last step in the 
configuration phase, the CLM creates a set of nondedicated data structures 
(tables, save areas, pointers, etc.), based upon the information contained in 
the previous commands. 


If the HLT parameter is present in the QUIT command, the processor will 
halt after the configuration loading is completed and before the application 
is started. The format of the QUIT command is shown below. 

QUITA[HLT][MAP] 
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QUIT - Command mnemonic. 

HLT - Specification of this parameter causes the machine to halt 
after loading and before beginning the execution of the 
application. The default assumption is not to halt. Do 
not execute a control panel master clear operation before 
application execution. 

MAP - Specifying this parameter causes ZXMAP to be loaded last 
(provided an operator console is present) automatically. 

ZXMAP must be on the same file as CLM. 

This parameter is equivalent to an implicit ADMOD command: 

ADMOD PROGFILE:ZXMAP 

STATION 

STATION Command 

This command is used to specify additional devices on lines controlled by 
LTP's that have been written to handle multiple devices per line. One device 
on the line must be identified by describing it in an LTPn command; additional 
devices are specified in STATION commands, one per device, immediately follow¬ 
ing their corresponding LTPn commands. The format of the command is: 

STATIONAlrn[,label][,LTP-specific-word] 

STATION - Command mnemonic. 

lrn - Specifies the logical resource number by which the device is 

requested; must be less than or equal to the hilrn parameter of 
the SYS command. 

label - A label, assumed to be a location definition, which must be 
defined in a load module. This label is the entry point to the 
attention subroutine. The default label for LRN 0 (operator's 
console) is ZIATTN, which is defined in the executive load 
module. The default for other LRN's is null. 

LTP-specific-word - A word containing user-defined information to be 
passed to the LTP via the station table at offset ZQSSTS. 

NOTE: The priority level, channel number, modem type, line speed, 

and line procedure (FDX/HDX) of devices described in STATION 
commands, are obtained from the preceding LTPn command. 


SYS Command (System) 


The SYS command defines the environment in which the online application 
will be run. When specified, the SYS command must be the first CLM command 
entered (with the exception of the IOS or DATE command). The format of the 
SYS command is: 


SYSA[,hilrn][,lolevel][,SAF][,D'himem'] 


SYS - Command mnemonic. 

hilrn - The highest logical resource number (LRN) to be used by 
the application. The specification of this operand de¬ 
termines the size of the logical resource table (LRT) 
for the application. (The size of the LRT equals hilrn+1.) 
The default value of hilrn is 15. The maximum value is 255. 
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lolevel 


The lowest priority level to be used by the application. 
This parameter also establishes the number of interrupt 
save areas (ISA's) and affects the total area set aside 
for ISA's and for the start-of-queue and end-of-queue 
header tables. The value of the lolevel operand must be 
between 6 and 62 inclusive. The default value is 15. 

SAF - Model designator. The default value is SAF. 

D'himem' - The double-word hexadecimal integer specifying a main 

memory address. The himem operand permits a main memory 
area between the end of the system and the physical end 
of memory to be used for nonsystem use (e.g., for storing 
an offline dump routine). The default value of the himem 
operand is the high-memory address of the loader. It is 
the end of the main memory area for buffers. 


TASK Command (Define Task) 


The TASK command defines an initial start address for a level. It is 
used for a task that requires exclusive use of a level (i.e., is requested by 
means of an implicit-start-address request block) or by an initially active 
application task. The format of the TASK command is: 

TASK start-address,lrn,level[,activity] 

TASK - Command mnemonic. 

start-address - An ASCII label that is the start address of the first 
task code to execute on a particular level after the system is 
started. The label is declared in an XDEF statement in an assem¬ 
bly language program, and an EDEF statement to the Linker. 

lrn - The logical resource number by which the task is requested. 

The value of this operand must be an integer no greater than the 
hilrn value specified in the SYS command. 

level - The priority level at which the task will execute. The value 
of the level operand cannot be less than 5 or greater than the 
value specified as the lolevel of the SYS command. 

activity - The value of this operand determines the setting of the 

level activity indicator. Possible values and their interpreta¬ 
tions are: 

YACT - The task is initially active. 

NACT - The task is not initially active. 

The default value is NACT. It is the task on the highest pri¬ 
ority level that has been declared active (by a YACT in its 
TASK command) that is entered when execution starts. 


TRAP Command (Trap Vector) 

The TRAP command establishes a relationship between a trap vector number 
and a trap handler name. During execution, trap handling procedures are 
activated only if the appropriate TRAP command has been specified. The three 
Honeywell-supplied trap handlers are the Trace Trap Handler, associated with 
trap vector 2, the Floating-Point Simulator, associated with trap vector 3, and 
the Scientific Branch Simulator associated with trap vector 5. 
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If the TRAP command is used, the trap handler must be in a load module to 
be loaded. Furthermore, the label of its entry point (i.e., the handler name) 
must be declared at link time with the EDEF Linker command. If more than one 
TRAP command is issued for the same trap vector number, the last TRAP command 
overrides all previous ones for the same trap number. There are no default 
values for this command. The command format is: 

TRAPAtrap-number,handler-name 

TRAP - Command mnemonic. 

trap-number - The number of the trap vector between 1 and 46. 

handler-name - A string of ASCII characters specifying the name 

(label) of the start of the trap handler. This label must be 
defined in the load module for this application. The three 
Honeywell-supplied trap handlers have the following names: 

1. ZXTRAC - Trace Trap Handler 

2. ZFPSIM - Floating-Point Simulator 

3. ZFBSIM - Scientific Branch Simulator 



TSA Command (Trap Save Area Definition) 

The TSA command defines the number and size of the items in the trap save 
area (TSA) list. When a trap occurs, certain pertinent information is stored 
in a trap save area item in main memory. The TSA command allows the adjust¬ 
ment of the number and size of these items for optimum memory usage. All 
items in the TSA list are of the same size. To find the total size of the trap 
save area, multiply the number of items by the size of each item. The format 
of the TSA command is shown below. 

TSAA[,number of items][,size] 

TSA - Command mnemonic. 

items - The number of trap save area items required. The default 
(and the minimum) value is 2. 

size - The size (in words) of one trap save area item. The default 
(and the minimum) value is 8. 



TTY Command 

This command identifies each teleprinter device in the application. The 
format of the TTY command is: 

TTYAlrn,level,channel[,label][,modem][,speed] 

TTY - Command mnemonic. 

lrn - The logical resource number by which the device is re¬ 
quested. It must be less than or equal to the hilrn 
parameter of the SYS command. 
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level 


- The priority level at which the driver for the device 
will execute. Must be less than or equal to the lolevel 
parameter of the SYS command; it may be the same as 
other communications devices, but must be different 
from the level for the COMM command, and from the levels 
of noncommunications tasks and devices. 


channel - The channel number of the device. 

label - A label, assumed to be a location definition, which must 

be defined in a load module. This label is the entry point 
of the attention subroutine. The default label for LRN 0 
(operator’s console) is ZIATTN, which is defined in the 
executive load module. The default for other LRN's is 
null. 

modem - A number specifying the type of data set. Possible values 
are; 


0 - direct connect 

1 - Bell lxx-type modem (103A,113F,etc). Both the data- 
set-ready and carrier-detect signals needed for a con¬ 
nection; the lack of both signals is a disconnection. 


2 - Bell 2xx-type modem (201A,201C,208A,etc.) The data 

set ready signal needed for a connection; lack of this 
signal is disconnection. 


3 or greater - User-defined modem type (see MODEM command). 
The default is modem type 1. 

speed - The data rate in bits per second. Possible values are: 


50 

300 

2400 

75 

600 

3600 

100 (default) 

900 

4800 

134.5 

1200 

7200 

150 

1800 

9600 


When this command is processed, an implicit ADMOD command 
is issued to include the teletype line type processor 
(ZQPTTY) in the load list. 


VIP 

VIP Command 


This command identifies each visual information projection (VIP) device 
in the application. The format of the VIP command is: 

VIPAlrn,level,channel[,label][,modem] 

VIP - Command mnemonic. 

lrn - The logical resource number by which the device is re¬ 
quested. It must be less than or equal to the hilrn 
parameter of the SYS command. 

level - The priority level at which the driver for the device 

will execute. Must be less than or equal to the lolevel 
parameter of the SYS command; it may be the same as other 
communications devices, but must be different from the 
level parameter in the COMM command, and from the levels 
specified for noncommunications tasks and devices. 
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channel - The channel number of the device. 

label - A label, assumed to be a location definition, which must 
be defined in a load module. This label is the entry 
point of the attention subroutine. The default is null. 

modem - A number specifying the type of data set. Possible values 
are: 

0 - Direct connect 

1 - Bell lxx-type modem (103A,113F,etc.). Both data-set- 

ready and carrier-detect signals needed for a connec¬ 
tion; the lack of both signals is a disconnection. 

2 - Bell 2xx-type modem (201A,201C,208A,etc.). The data 

set ready signal needed for a connection; lack of this 
signal is a disconnection. 

3 or greater - User-defined modem type. (See MODEM command.) 
The default is modem type 2. 


When this command is processed, an implicit ADMOD command is issued to 
include the VIP line type processor (ZQPVIP) in the load list. 


* 

*Command (Comments) 

The comments command is used only for documenting the command input listing. 
These comments are bypassed by the CLM. The format of the command is shown 
below. 

*Acomments 

* - Command mnemonic. 

comments - A string of ASCII characters, up to one line in length, 
specifying the comments. 
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APPENDIX B 

PLANNING AND BUILDING WITH EXECUTIVE OBJECT MODULES 


The Honeywell-supplied diskette contains a map file, CLMMAP. Members of 
this file document the Linker command and Linker map output for the load 
modules created by Honeywell. This appendix indicates approaches you may use 
to create your own Executive and/or driver load modules from Executive object 
modules. 

CREATING EXECUTIVE LOAD MODULES 

The Honeywell Executive, ZXEX03, consists of the object modules shown in 
Table B-l. 


Table B-l. Executive Object Modules 


Description 

Object Module Name 

Task Manager 

ZXTSKM.O 

Clock Manager (basic) 

ZXCMGR.O 

Clock Manager (time-of-day, 
date) 

ZXCTDA.O 

Operator Interface Manager 
(console) 

ZIOIM.O 

Operator Interface Manager 
(panel) 

ZIOIMP.O 

Trace Trap Handler 

ZXTRCM.O 

I/O Subroutines 

ZIOSUB.O 

System Error Handler 

ZUERR.O 

Executive Initialization 

ZXIN03.O 

Semaphore Routine 

ZXSEM.O 


If you want to omit one or more of the Executive functions, you must build 
your own load module from the Executive object modules. 

Listings of the ZXEX03 modules indicate which modules are being initialized 
The general procedure for you to follow when preparing your own executive load 
module is to examine the existing load module's initialization code for an 
explanation of its functions. 
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The initialization subroutine table (1ST) at the start of the initializa¬ 
tion module is composed of at least one subroutine entry per module served. 

This means that a module being deleted should have its initialization subrou¬ 
tine (s) deleted. The converse is also true; a user-created module which had 
initialization requirements could be added to the existing 1ST (assuming the 
source was available.) 

Figure B-l shows the general structure of initialization subroutines along 
with a detailed sample 1ST. 


ZXXIST 

DC 

0 

START OF 1ST 


RESV 

$AF, 0 



DC 

<ZX0BJ1 

OBJECT 1 INITIALIZE 


DC 

0 

PARAMETERS 


DC 

0 



DC 

<ZX0BJ2 

OBJECT 2 INITIALIZE 


DC 

0 

PARAMETERS 


DC 

0 



DC 

<ZX0BJ3 

OBJECT 3 INITIALIZE 


DC 

0 

PARAMETERS 


DC 

0 



RESV 

$AF, 0 

END OF 1ST 


OBJECT 1 


OBJECT 2 


OBJECT 3 


OBJECT 4 



MODULE 


Figure B-l. Initialization Processing 

Subroutines of Honeywell-supplied initialization code are functionally inde¬ 
pendent. 

To summarize, there are two areas of concern when creating your own load 
module: 

• Proper Linker commands, especially EDEF's needed by CLM. 

• Proper 1ST subroutine entries in new initialization for object 
modules used by new load module. 

Linker commands may be determined by examination of Honeywell-supplied link 
maps (CLMMAP). 1ST entries may be constructed by examination of Honeywell 
initialization module listings. 
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As an example of a user-created executive load module, assume that the 
application needs the following existing Executive functions: task, both 
clock functions, the operator interface for the console, the error subrou¬ 
tines. Furthermore, the Buffer Manager is to be added. 


A listing of ZXEX03 must be examined along with the listing for the Buffer 
Manager (ZXBM01) for 1ST contents. Note that some of the Buffer Manager 
initialization code must be permanently resident, and cannot be overlaid. A 
new initialization load module is created containing all the required initial¬ 
ization code for the functions to be included in the new executive load module. 
The 1ST is located to accommodate the buffer initialization requirements. 

(See Figure B-2.) 


START 



END NEWINT, START 


SUBROUTINE FOR CLOCK 
DURING LOADING 

SUBROUTINE FOR BUFFERS 
DURING LOADING 


Figure B-2. New Initialization Modules 

The link commands (from CLMMAP) for the new load module are all those 
required for the modules to be used. Note that the LINKN for the ZXEX03 
initialization (ZXIN03) is not used because the entire Executive module is not 
being used. After all the link commands have been collected (including all 
necessary EDEF's), the Linker is then executed to produce the new load module 
that now contains the required executive functions. 

I/O drivers should remain separate load modules to retain variable selec¬ 
tion during configuration using the CLM device commands (DEVICE, TTY, VIP, 

BSC), and to maintain compatibility with CLM embedded file/member and start 
address names. 
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APPENDIX C 

APPLICATION CONFIGURATION EXAMPLE 


This appendix provides two examples of application programs. Each example 
contains the Linker, and CLM commands for the application along with a listing 
of the application program. 

The first example presents an input/output program, BRDCST, whose purpose 
is to exercise the various device drivers provided with the BES software. 

The second example is a communications test program, COM200. 


CONFIGURATION COMMANDS FOR SAMPLE INPUT/OUTPUT APPLICATION 


The following configuration commands are used to configure the sample 
application. No SYS or TSA command is used since default values are assumed. 


CLOCK 60,50 

ADMOD PROGFILE:ZXEX03,X'1200' 
ADMOD USRPGS:BRDCST,X'1200' 
TASK BRDCST,1,10,YACT 
DEVICE CDR,2,7,X'058 0' 

DEVICE LPT,5,9,X'1300' 

DEVICE DSK,4,8,X'1200* 

DEVICE ASR,0,6,X'1380' 

EQLRN 3,6 
ATLRN 6,11 
ATLRN 7,12 
ATLRN 8,8 
EQLRN 9,6 
EQLRN 10,6 
EQLRN 11,6 
ATLRN 12,13 
ATLRN 13,14 
QUIT HLT 


(Execution LM) 

(Application LM) 

Application LVL 10 (initially active) 
Card reader LVL 7 
Line printer LVL 9 
Disk LVL 8 

Operator's console LVL 6 
Teletype LVL 6 
Input Task LVL 11 
Output Task LVL 12 
Disk out LVL 8 
Teletype out LVL 6 
ASR in LVL 6 
ASR out LVL 6 
Output Task 2 LVL 13 
Output Task 3 LVL 14 


LINK COMMANDS FOR SAMPLE INPUT/OUTPUT PROGRAM 


The following commands are used to produce the load module BRDCST prior to 
invoking CLM to configure an application using the program: 

NAME BRDCST 
LINK BRDCST 
EDEF BRDCST 
MAP 
QUIT 


SAMPLE INPUT/OUTPUT PROGRAM 

The following pages show a documented listing of the BRDCST program. 
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o 

I 

N) 


000001 




000002 



* 

000003 



* 

00000A 



* 

000005 



* 

000006 



* 

000007 



* 

000008 



* 

000009 



★ 

000010 



★ 

000011 



★ 

000012 



* 

000013 



* 

00001 A 



* 

000015 



* 

000016 



* 

000017 



* 

000018 



* 

000019 



* 

000020 



* 

000021 



* 

000022 



★ 

00 002 3 



* 

00 00 2 A 



* 

000025 



* 

000026 



* 

000027 



* 

000028 



* 

000029 



* 

000030 



★ 

000031 



* 

000032 



* 

000033 



* 

00003A 



* 

000035 



* 

000036 



it 

000037 



* 

000038 



* 

000039 



* * * * ** 

OOOOAO 



***** 

00 00 A1 



* ** * 

00 00A 2 



* ** 

0000A3 



* * 

OOOOAA 



* 

0000A 5 



* 

0000A6 

0000 

2 02 0 

BLNK S 

00 00 A 7 

0001 

3939 3939 

TERM 

OOOOA 8 



* 

00 00A 9 



* 

000050 

0003 


0EVT8L 

000051 

0003 

0008 


000052 

OOOA 

001 3 


000053 

0005 

001 B 


00005A 

0006 

0028 


000055 

0007 

002 3 


000056 

0008 

0 03 3 


000057 

0009 

0038 


000058 

OOOA 

OOA 3 


000059 



* 


TITLE BR oCST 

THIS TEST PROGRAM IS A 
MEDIA TRANSCRIPTION TEST. 

IT CAN EXECUTE AS AN 
ON-LINE OR OFF-LINE 
DRIVER TEST...... 

THE OPERATOR WILL TYPE 
OXO YOYOY 

x= input dev number y = Output dev number 

0= CARD READER 
1= TELETYPE 
2 = DISKETTE IN 
3= PRINTER 
4= DISKETTE OUT 
5= TELETYPE OUT 
6= ASR IN 
7 = ASR OUT 


LRN 0=0P CONSOLE 

LRN 1 =CONT ROL TASK 

LRN 2 * CARD READER 

LRN 3*TELETYPE IN 

LRN AsDISKETTE IN 

LRN 5= PRINIER 

LRN 6=1NPU T TASK 

LRN 7=0UTPUT TASK 

LRN 8* DISK £ TTE OUT 

LRN 9* TELE T yp E OUT 

LRN 10 =ASR IN 

LRN 11=ASR OUT 

LRN 12 *OUTPUT TASK2 

LRN 13 *OUTP UT TASK3 


LRN TABLE 


TEXT ' • 

TEXT '9999' TERMINATION CHARACTERS 


RES V 0 


DC 

<C RDBLK 

LRN 

2 

DC 

<T TYBLK 

LRN 

3 

DC 

<DSKBL I 

LRN 

A 

DC 

< P RT8L K 

L£N 

5 

DC 

< D SKBL 0 

LRN 

8 

DC 

<T TYOUT 

LRN 

9 

DC 

< ASRINP 

LRN 

10 

DC 

<A SROU T 

LRN 

11 




AU4 9 


COM?00 

7606?? 

L b AS.6f.M8LE9-O?O0 

COMM test 

PROGRAM 

PAGF 0002 


n o n 0 6 n 


On 1 « 

DISCOM 

f OU 

$ 


0 on o 61 

00 18 

0 0 0 0 


RES V 

* AF , 0 


00006? 

00 1 o 

0 00 1 


DC 

V * 0 1 • 

WAIT TILL I/O COMPLETE 

000063 

00 1 4 

0 U (1 6 


DC 

X•408 ' 

disconnect 

000064 

0 0 1 8 

o o o o 


RES V 

* A5,0 

BUFFER 

000065 

o o i r 

0 0 0 1 


DC 

1 

BANGEsl word 

000066 

(10 1 n 

0030 


DC 

x' 30' 


000067 

0 0 1 E 

0 0 o 0 


DC 

X 'O' 


000066 

0 0 1 F 

0 0 0 0 


DC 

X 1 0 ' 


000060 



* 


A 


000070 



* 

* 

AIORB‘COMMUNICATIONS CONSOLE INPUT* 

000071 



* 


A 


0 0 0 0 7 ? 


0020 

COMCI 

EQU 

% 


0 o 0 0 7 3 

0020 

0000 


RFSV 

$AF,0 


000074 

0021 

000 1 


DC 

X'Ol ' 

WAIT TILL I/O COMPLETE 

000075 

002 ? 

0402 


DC 

X'402' 

READ 

0 0 () 0 7 6 

00 23 

0 15 8 


DC 

<COVBFR 

BUFFER ADDRESS 

000077 

00?4 

0 0 4 8 


DC 

72 

RANGFs72 

0 0 0 0 7 8 

0 o ?5 

0030 


DC 

X ' 30 ' 

ECHO, L.F. &C/R 

000079 

0 0?6 

0 000 


DC 

X ' 0 * 


000080 

0027 

0000 


DC 

X » 0 ' 


000081 



★ 


A 


00008? 



* 

* 

★IORBsCOMMUNICATIONS CONSOLE OUTPUT 

000083 



* 


A 


000080 


0028 

COMCO 

EQU 

$ 


0 0 0 0 8 5 

0028 

0000 


RESV 

SAF,0 


000086 

0 0 29 

0 0 01 


DC 

X'Ol ' 

WAIT TILL I/O COMPLETE 

000087 

00?fl 

04U1 


DC 

X * 44 1 • 

WRITE, CONTROL BYTE RIGHTMOST 

000088 

0028 

0 1 A 6 


DC 

<LPBUF1 

BUFFER START ADDRESS 

0 0 0 0 8 9 

002C 

0049 


DC 

73 

73=RANGE 

000090 

0020 

0 0 30 


DC 

X * 30 ' 

FCHO, LINE FEED AND C/R 

000091 

0 0 ?E 

0000 


DC 

X'O' 

RESIDUAL RANGE 

000092 

0 0 25 

0O00 


DC 

X * 0 ' 

STATUS WORD 

000093 



* 


A 


000094 



* 

A 

aTORBsCARD 

READER INPUT 

000095 



* 


A 


000096 


0 0.30 

CORIM 

EQU 

$ 


000097 

0030 

oooo 


RESV 

SAF, 0 


000098 

0031 

0001 


DC 

X'Ol' 

WAIT 

000099 

0032 

0302 


DC 

X'302' 

READ CARDS 

000100 

0033 

01CF 


DC 

<CDRBUF 

BUFFER 

000101 

0034 

0050 


DC 

BO 

80-CHARACTER RANGE 

000102 

0 0 35 

000 0 


DC 

X'O' 

ASCII MODE 

000103 

0036 

0 00 0 


DC 

X'O' 


000104 

0037 

0 00(1 


DC 

X'O' 


000105 



★ 


A 


000106 



* 

A 

*!0RBttINE 

PRINTER OUTPUT 

000107 



* 


* 


n o o i o e 


0038 

LPTOUT 

EQU 

$ 


000109 

0038 

0000 


RESV 

SAF , 0 


ooono 

0 0 39 

0001 


DC 

X'Ol' 

WAIT 

000111 

00 3A 

0241 


DC 

X » 24 1 ' 

WRITE/CONTROL BYTE RIGHTMOST 

000112 

0 0 38 

0 1 A 6 


DC 

<LPBUF1 

BUFFER 

0001 1 3 

003C 

0049 


DC 

73 


0001 14 

0030 

0000 


DC 

X'O' 


0001 1 5 

0 0 3F. 

0000 


DC 

X'O' 


0001 1 6 

003F 

0000 


DC 

X'O* 


000117 



* 


A 


0001 1 8 



* 

A 

★BEGIN 


000119 



* 


A 




AU49 


000120 
000121 
000122 
000123 
000124 
00012 5 
000126 
000127 
000128 
000129 
000130 
000131 
000132 
0001 33 
000134 
0001 35 
000136 
000137 
000138 
0001 39 
000140 
00 01 41 
000142 
00 014 3 
000144 
000145 
000146 
0001 47 
00 014 8 

O 000149 

I 000150 

0001 51 
000152 
0001 53 
000154 
000155 
000156 
000157 
0001 58 
0001 59 
000160 
000161 
000162 
0001 63 
000164 

000165 

000166 

0001 67 

000168 

000169 
0001 70 

000171 

0001 72 


009C 0000 

0090 0000 

009E 0600 

009F 013 F 


OOAO 0000 
00A1 0000 

OOA2 0700 
00A3 0150 


00A4 0000 

00A5 0000 

00A6 OCOO 
OOA 7 0161 


00A8 0000 

00A9 0000 

oqaa oooo 

00AB 0171 


OOAC 0000 
OOAd 0001 
OOAE 0001 
OOAF 0084 
0080 0065 

00B1 0000 

00B4 2063 7264 2072 

0087 6472 3d30 

00B9 2074 7479 2069 

OOBC 6E3D 3100 
008E 2064 6973 6820 

00C1 6 96 E 3032 

00C3 2070 726E 7472 

00c 6 3D33 

OOC7 2064 6973 6B20 

OOCA 6 F7 5 7430 3400 
OOC D 0 DOA 

OOCE 2074 7479 206F 
00D1 7574 3035 

0003 2061 7372 2069 

0006 6E30 3600 

OOo8 2061 7372 206F 



TASK 1 

(INPUT) 

REQUEST BLOCK LRN 6 

RES V 
DC 

oc 

DC 

1*0 

X'0000* 
X* 0600* 
<1 NSTRT 




TASK 2 

(OUTPUT) 

REQUEST BLOCK LRN 7 

RES V 
DC 

DC 

DC 

1/0 

X* 0000* 
X* 0700* 
KOUTSTR 



0UTPUT2 TASK 

REQUEST 

BLOCK 

RES V 
DC 

DC 

OC 

1/0 

X* 0000* 
X* OCOO* 
C0UT2ST 



OUT PUT 3 TASK 

RE QUEST 

BLOCK 

RES V 
OC 

DC 

DC 

1/0 

X* 0000* 
X* ODOO* 
<0 UT3S T 





START-UP I/O 

REQUEST BLOCK(OUT) 

RE S V 

1/0 


DC 

X * 01 * 


DC 

X* 0001 * 

LRN 0 

DC 

<0 UTMSG 


DC 

10 1 


RESV 

3/0 


TEXT 

* crd r dr =0 * 


TEXT 

' tty i n= 1 ' 


TEXT 

* disk in*2* 


TEXT 

* prntr=3* 


text 

* disk out *4' 


DC 

Z'odqa* 


TEXT 

' tty out=5* 


TEXT 

' asr in*6' 



TEX T 


asr o ut = 7 





AU4 9 


n 

i 

U1 



00 DB 

7574 

3037 





000173 

OOdD 

OoOA 




DC 

Z ' OdOA * 

000174 

OODE 

207 4 

7970 

6 520 


TEX T 

• type OnOyOyOy* 


OOEl 

306e 

3079 

3079 






307 9 






0001 7 5 





★ 



000176 





* 

STARTUP I/O REQUEST BLOCK 

0001 77 





* 



000178 

OQE 5 

0000 



INPM SG 

RES V 

1*0 

00 01 79 

00E6 

0001 




DC 

X* 01* 

000180 

00E7 

000 2 




DC 

X* 0002 * 

000181 

00E8 

OOED 




DC 

<INMSG 

000182 

00E9 

0008 




DC 

8 

000183 

0 OE A 

0000 




RES V 

3,0 

000184 

OOED 

2020 

20 20 

2020 

I NMS q 

TEX T 

• 


OOF 0 

2020 






000185 





k 



0001 86 





k 



00 018 7 

OOF 1 

ooa c 



PARI ST 

DC 

<M ESSAG PARAMETER LI 

000188 

OOF 2 

OOe 5 




DC 

<INPMSG 

000189 

OOF 3 

0000 




DC 

0 

0001 90 

00F4 

0000 




DC 

0 WORK W ORD S (P 

000191 





ilr 



000192 





* 



000193 





* 



000194 





* 



000195 





* 



000196 





* 

I/O 

ERROR MESSAGE IORb 

0001 97 





★ 



000198 





★ 



000199 

00 F 5 

0000 



ERRM SG 

RES V 

1,0 

000200 

00 F 6 

0001 




OC 

x* or 

000201 

OOF 7 

0041 




DC 

X * C041 * 

000202 

0 0 F 8 

OOF D 




OC 

< ERROR 

000203 

00F9 

001 1 




DC 

1 7 

000204 

OOF A 

0000 




RES V 

3,0 

000205 

OOFD 

0041 



E RRO R 

DC 

X * 0041 * 

000206 

00 F E 

6465 

7630 



TEXT 

* d ev*' 

000207 

0100 

0000 



DEV A SN 

DC 

X’ 0000* 

000208 

0101 

2065 

72 72 

6 F 72 


TEXT 

' error*' 


0104 

3 DOO 






000209 

0105 

0000 



S TAT US 

DC 

X* 0000* 

000210 





* 



000211 





* 



000212 


0001 



$LVC T1 

EQU 

1 

000213 


000 2 



$LVC 12 

EQU 

2 

000214 


000 5 



$LVC T5 

EQU 

5 

000215 


004 0 



SLW8 T 

EQU 

X • 40* 

000216 


OOE F 



0UTSK2 

EQU 

<INMSG+2 

000217 


OOF 0 



OUT S k3 

EQU 

<INMSG + 3 

000218 





* 



000219 





★ 



000220 





* 



000221 





* 

TYPE 

STARTUP MSG,WAIT FOR REPLY 

000222 





★ 



000223 

0106 

CC80 

00F2 


BRDC ST 

L DB 

$B4,<PARLSI+$LVCT1 

000224 

0108 

9870 

2020 



LDR 

$R 1 ,=Z * 2020* 

000225 

010A 

9F00 

00 EE 



STR 

$ R 1 ,<INMSG + 1 

000226 

OIOC 

9 FO 0 

OOEF 



S TR 

$ R1,<INMS G + 2 

000227 

0 1 OE 

9F00 

00 FO 



STR 

$R 1 ,<1NMS G + 3 


WORD TOO) 



AU49 



000343 

0 181 

82C 4 

0001 


I OK 

LB 

$B4.$LVCT1/X*0020' DO BIT TEST 



0183 

002 0 








000344 

0184 

0580 

0188 



BBF 

<N OTDSK 

NOT A DISK IF B IT *0 


000345 

0186 

B84 4 

0005 



LDR 

SR3#$B4.SLVCT5 

load current sector into R3 


000346 

0188 

8 AO 3 




I NC 

= $ R3 

BUMP IT BY 1 


000347 

0189 

BF4 4 

0005 



S TR 

$R3/SB4.SLVC T5 

PUT IT BACK WHERE IT BELONGS.. 


000348 

0188 

0 38 0 

0000 

X 

NOTO SK 

LNJ 

SB 5,<Z X TE RM 

NOW YOU CAN POST + TERMINATE 


000349 





* 





000350 





* 

THE FOLLOWING CODE IS 

AN ERROR ROUTINE 


000351 





it 

IT DISPLAYS THE DEVICE 

NUMBER AND THE 


000352 





it 

STATUS 

CODE ON THE OP 

CONSOLE THEN IT 


00 03 5 3 





* 

RETURNS CONTROL AT THE 

POINT THE I/O 


000354 





* 

ORDER 

WAS REQUESTED, it RUNS AT THE 


000355 





* 

LEVEL 

OF THE OFFENDING 

KOUTINE. 


000356 





* 





000357 

018D 

8 951 



ERRO IT 

LBT 

=SR1,Z * 3030* 

MAKE I T TYPEABLE 



01 8E 

3030 








000358 

0 1 8 F 

9 FO 0 

0105 



STR 

SR1,<STATuS 

THROW STATUS IN BJ FFER 


000359 

0191 

AFOO 

01 00 



STR 

SR 2/<D EVASN 

THROW DEVICE NUMBER IN SAME 


000360 

0193 

C F80 

01 9C 



STB 

SB4,<S T0RB4 

HOLD RETURN ADDRESS 


000361 

0195 

CB8 0 

OOFS 



LAB 

SB4 /<E R RM S G 

AND SETUP FOR 


000362 

0197 

0 38 0 

0000 

X 


LNJ 

$8 5,<Z I OR E Q 

THE ERROR TYPEOUT 


000363 

0199 

CC80 

01 9 C 



LDB 

$8 4,<S T OR 84 

LOAD RETURN ADDRESS IN B4 


000364 

019B 

8 384 




J HP 

SB 4 

GO BACK AND RE-ISSUE ORDER 


000365 





★ 





000366 

0 1 9 C 

000 0 



ST0RB4 

RESV 

1,0 

B4 HOLD WORD 


000367 





★ 





000368 





★ 





000369 





* 




Q 

000370 





* 

XDEFS 

ANO XLOCS 



000371 





* 




<j\ 

000372 


0150 




XOE f 

outstr,instrt,bRocst 




013 F 










0106 








000373 






xloc 

ZlTYPR,ZXR3ST,ZIOHEQ,ZXTERM 


000374 

0 1 9 D 





END 

BR DCST 



0000 ERR COUNT 




CONFIGURATION COMMANDS FOR SAMPLE COMMUNICATIONS APPLICATION 


The following commands are used to configure the sample communications 
application. The absence of a TSA command indicates that default values were 
taken. 


LACT CLMCOMM:COMM 
ELACT 

SYS 16,22,SAF 
OIM 5,11 
COMM 7 

TTY 4,10,X'FDO0',,0 
ADMOD PROGFILE:ZXEX03,X'04 00 ' 
ADMOD LINKFILE:COM200,X'0480' 
CLOCK ,50 

DATE '760622','1200' 

DEVICE KSR,0,6,X*0500' 

DEVICE LPT,2,8,X*1380' 

DEVICE CDR,3,9,X'1300' 

TASK GLUE,6,12,YACT 
QUIT HLT,MAP 


LINK COMMANDS FOR SAMPLE COMMUNICATIONS PROGRAM 

The following commands are used to produce the load module COM200 prior to 
invoking CLM to configure an application using this program: 

NAME COM200 
LINK COM200 
MAP 

EDEF GLUE 
QUIT 


SAMPLE COMMUNICATIONS PROGRAM 


The following pages show a documented listing of the COM200 pagram. 


** CO^POO LTV* 

** g T A r T 

** 1.0 >‘i 0 0 0 0 

**HIGH 0?P6 

**CU«KENT 0P4p 


**FXT DEFS 


P ZHCOMrv* 

0 0 0 0 

P ZHPPL 

r» o o o 

* COM2 0 0 

0 0 0 0 

GL»»F. 

ooao 

**U\'0£F 


* COM?00 

0 0 0 0 

2 i nPfcto 

0 1 P 1 

z*cTon 

cue 

ZXCMGP 

0 1 P 7 

IPG IPIOEF 



C-7 


AU49 



AU49 


coupon 

76062? 

lb iS?E M «LE»-0?00 

CO“.u 

TEST RROGRA*» 

PAGE 0001 


OOOOOl 




TTTLF 

Com?00, • 76062? 

' COMM TEST program 

ooono? 



* 


* 


00000'S 



* 


♦EXTERNALS 


000000 



* 


♦ 


ooooos 




XLOC 

ZTORFQ 

INPUT-OUTPUT DRIVER 

000006 




XLOC 

7 X C TOD 


000007 




XLOC 

zxcwrp 

CLOCK MANAGER 

oooooa 




XLOC 



000009 


oooo 


XOEF 

GLUE 


000010 



★ 


* 


000011 



* 

* 

* I DPR s-L AftEl.tD 

displacements 

00001? 



it 


* 


oooo 1 3 


oooo 

ZI&LNK 

E 0 11 

0 

LINK 

oooo 1 a 


0001 

ZI&CT1 

EQU 

ztrlnk+taf 

CONTROL WORD 1 

000015 


0002 

ZIPCT2 

EQU 

ZIRCT1+1 

CONTROL WORD 2 

000016 


0003 

7ISBAD 

EOU 

7TRCT2+1 

BUFFER ADDRESS 

000017 


Oooo 

ZTRRtift 

EOU 

ZIRRAD+SAE 

RANGE 

oooo i a 


0 005 

ZIROVS 

EOU 

7TRRNG+1 

DEVICE SPECIFIC 

0 0 0 0 1 9 


0006 

ZIRRSP 

EOIJ 

ZIRDVS+1 

residual range 

0000?0 


0007 

7IRST1 

EOU 

Z IP R S R + 1 

SOFTWARE STATUS WORD 

000021 



+ 


* 

oooo?? 



+ 

★ 

♦IORR!CONSOLE 

INPUT* * 

000023 



* 


* 


oooo?o 


oooo 

K 8 R IM 

EOU 

$ 


000025 

oooo 

OOOO 


PE S V 

*AF, 0 


oooo?fe 

0001 

0001 


OC 

X'01 ' 

WAIT TILL I/O COMPLETE 

000027 

0002 

0002 


DC 

X»0?' 

read 

00002 a 

0003 

0 1 A8 


OC 

<ksprue 

BUFFER ADDRESS 

000029 

oooo 

0006 


nc 

6 

RANGE in bytes 

000030 

0005 

0030 


oc 

x'30' 

C/R, LINE FEED, &ECHO 

000031 

0006 

OOOO 


oc 

X ' 0 • 

residual range 

0 0 0 0 3? 

0007 

oooo 


OC 

X ' 0 ’ 

STATUS 

000033 



* 


* 


000030 



* 

* 

♦TORRiCONSOLE 

OUTPUT 

000035 



* 


* 


000036 


0 0 0 6 

KSRHUT 

EQU 

$ 


000037 

0008 

oooo 


9ESV 

SAF. 0 


00003 a 

0 0 0 0 

000 1 


OC 

x '01 ' 

WAIT 

000039 

0 0 Q A 

OOo 1 


OC 

x‘ 01 ' 

WRITE 

OOOOUO 

0008 

0 1 AC 


oc 

<LP8UF l 

BUFFER 

oooooi 

0O0C 

0010 


oc 

20 

RANGE IN BYTES 

ooooo? 

OOOO 

0030 


oc 

X ' 30 • 

C/R, L.F., 3 ECHO 

000003 

OOOE 

oooo 


DC 

X • 0 ' 


oooooa 

00 OF 

OOOO 


DC 

X ' 0 ' 


000005 



* 


• 


000006 



* 

* 

*TDRR sCONNECT 

COMMUNICATIONS CONSOLE* 

000007 



* 


* 


000008 


0010 

CONCOM 

EOU 

( 


000009 

0010 

oooo 


RES V 

% AF, 0 


000050 

0011 

0 00 1 


DC 

X'01 ' 

WAIT TILL I/O COMPLETE 

000051 

00 1? 

00(1 A 


DC 

X ' OOA ' 

CONNECT 

00005? 

00 13 

oooo 


RESV 

SAF, 0 


000053 

0010 

000 1 


DC 

1 

RANGE=1 WORD 

000050 

00 15 

0030 


DC 

X ' 30 • 


000055 

00 16 

OOOO 


DC 

X ' 0 ' 


0 0 0 056 

0017 

oooo 


DC 

X ' 0 ' 


000057 



★ 


* 


0 0 ci 0 5 a 



* 

* 

♦IORRjDISCOMNECT COMMUNICATIONS CONSOLE* 

000059 



it 


★ 




AU49 


00 006 0 

oooe 

0000 

C RDBLK 

RES V 

1 , C 

CARD READER 

000061 

oooc 

0001 


DC 

X * 01 • 

I/O 

000062 

OOOd 

0 20 2 


DC 

X' 02U2 * 

CON TROL 

000063 

oooe 

004 C 


DC 

<8 UFFE R 

BLOCK 

000064 

OOOF 

0050 


DC 

80 


000065 

0010 

0000 


RES V 

3,0 


000066 



* 




000067 

001 3 

0000 

1 TYBLK 

RES V 

1,0 

TTY (INPUT ) 

000068 

0014 

0001 


OC 

x* 01* 

I/O 

000069 

001 5 

0 342 


DC 

X •0342 ' 

C ON TROL 

000070 

0016 

004B 


DC 

<B UFFEP 

BLOCK 

000071 

0017 

0050 


DC 

80 


000072 

0018 

0000 


RESV 

3,0 


000073 



* 




000074 

001B 

0000 

oskbu 

RES V 

1,0 

DISKETTE INPUT 

000075 

001 C 

002 1 


DC 

X • 0021 ' 

I/O 

000076 

001 D 

0402 


DC 

X* 0402 * 

C ONTROL 

000077 

00 1 E 

0 04 C 


DC 

<B UFFE R 

block 

000078 

001 F 

0050 


DC 

80 


000079 

0020 

0000 


RES V 

3, 0 


000080 



* 




000081 

0023 

0000 

DSKB LO 

RESV 

1,0 

DISKETTE OUTPUT 

000082 

0024 

002 1 


DC 

X ' 0021 * 

I/O 

000083 

0025 

0801 


DC 

X' 0801 * 

C ONTROL 

000084 

0026 

0 04 C 


DC 

<BUFFE R 

BLOCK 

000085 

0027 

005 0 


DC 

80 


000086 

0028 

0000 


RESV 

3,0 


000087 



* 




000088 

0028 

0000 

PRTBLK 

RESV 

1,0 

PR INTER 

000089 

002C 

0001 


DC 

X * 01 • 

I/O 

000090 

0020 

0 541 


DC 

X* 0541 • 

CON TROL 

000091 

002 E 

004 B 


DC 

<8UFFEP 

BLOCK 

000092 

002F 

005 0 


DC 

80 


000093 

0030 

0000 


RES V 

3,0 


000094 



* 




000095 

0033 

0000 

TTYOOI 

RESV 

1,0 

TTY (OUTPUT) 

000096 

0034 

0001 


DC 

X ' 01 * 

I/O 

000097 

0035 

0941 


DC 

X • 0941 ‘ 

CONTROL 

000098 

0036 

004 8 


DC 

<8 UFFE P 

BLOCK 

000099 

0037 

005 0 


DC 

80 


000100 

0038 

0000 


RESV 

3,0 


000101 



* 




000102 

0038 

0000 

ASR1NP 

RESV 

1,0 

ASR (INPUT) 

000103 

003C 

0001 


DC 

X* 01* 

I/O 

000104 

003D 

0a02 


DC 

X •0A02 * 

CONTROL 

000105 

003E 

004 C 


DC 

<BUFFER 

BLOCK 

000106 

003F 

005 0 


DC 

80 


000107 

0040 

004 4 


DC 

X • 0044 * 


000108 

004 1 

000 0 


RESV 

2,0 


000109 



* 




0001 1 0 

0043 

0000 

ASROOT 

RESV 

1,0 

ASR (OUTPUT) 

000111 

0044 

0001 


DC 

X* 01 ' 

I/O 

000112 

0045 

ObOI 


i C 

X' OBOI* 

CON TROL 

00011 3 

0046 

004 C 


DC 

<BUFFER 

BLOCK 

000114 

0047 

0050 


DC 

80 


000115 

0048 

004 4 


DC 

X ' 0044 * 


000116 

0049 

0000 


RESV 

2,0 


000117 



* 




000118 

004 B 

004 1 

BUF f EP 

DC 

X ■ 0041 ' 

CARRIAGE CONTROL CHARACTER PRINT + SPACE 

000119 

004C 


BUF F ER 

RESV 

80 




-10 AU49 


o 


COMJOO 70062? 

L 6 

assembler 

-0200 

COMM 

TEST PROGRAM 

PAGE 0003 

000120 

r>040 

CB8 0 

0010 


GLUE 

LAB 

*94,<CONCOM 

000121 

0042 

0 3 8 0 

000 0 

X 


LNJ 

SR5»< ZIPRF Q 

000122 

0044 

F 38 0 

0067 



LNJ 

SR7,<CLFAPR 

000123 

0046 

8820 

0236 


QUERY 

L DR 

SR3,<nUFS.SR? 

000124 

0 0 4 6 

RF?0 

01 A7 



STR 

*R3,<LPBMF2.SR2 

0001P5 

004 A 

2F.0 1 




A 0 V 

*R?, 1 

000126 

0 0 4 R 

2D 0 4 




CMV 

SR?,4 

000127 

0 0 4C 

0981 

FFF9 



RNE 

QUERY 

O0012B 

004E 

8800 

0 ? 1 c 



LOR 

SR3,<BELLS 

000129 

0050 

PF20 

0 1 A7 



STR 

SR3, <L.PRUF2. SR? 

000130 

0052 

C880 

0008 



LAB 

SB4,<KSROUT 

000131 

0054 

4 C 0 9 




LDV 

SP4.9 

000132 

0055 

C F 4 4 

0004 



STR 

SR4 ,SR4.ZJRRNG 

000133 

0057 

D3P0 

0000 

y 


LNJ 

$R5,<7IPRFQ 

000134 

0059 

0F81 

0007 



B 

KRF AD 

000135 

005R 

C860 

00 18 


OISCON 

LAB 

SR4,<DISCOM 

000136 

0050 

038 0 

0000 

X 


LNJ 

SB5,<7I0REG 

000137 

005F 

0F81 

0 1 E 3 



B 

FINIS 

000138 

0061 

CR60 

oooo 


KREAD 

LAB 

SB4,<KSPIN 

000139 

0063 

D380 

0000 

X 


LNJ 

SB5,< Z10 R E Q 

000140 

0065 

0FB1 

0050 



8 

GETCH 

000141 





* 


* 

000142 





* 

* 

★ERROR ROUTINES 

000143 





* 


* 

000144 

0067 

CP 80 

0008 


CLEARR 

LAB 

*R4,<k SPOUT 

0 0 01 45 

0069 

A BP 0 

01 A 6 



LAB 

SR2,<LPRUF1 

000146 

006R 

AFC4 

0003 



STB 

SB2,SB4.ZIRRAD 

000147 

0 06D 

8752 




CL 

= SP? 

0 0 0 1 4 B 

0 0 6E 

P BP 0 

01 A7 



LAB 

SB3,<L PBUF2 

000149 

0070 

2C?4 




LDV 

$ R 2,3 6 

000150 

0071 

D3B0 

0 1 4 E 



LNJ 

SB5,<SPACIT 

000151 

0073 

8752 




CL 

s SR ? 

000152 

0074 

8387 




JMP 

SB7 

000153 





* 


★ 

000154 

0075 

4C0F 



ERRMSG 

LDV 

SRO, 15 

000155 

0076 

C F4 4 

0004 



STR 

SR4,SB4.ZIRRNG 

000156 

0078 

B820 

0210 



LOR 

SR3,<MSG1.SR2 

000157 

0 0 7 A 

BF20 

01 A7 



STR 

SR3,<LPBUF2.SR2 

000158 

007C 

2E0 1 




ADV 

SR2, 1 

000159 

0070 

2007 




CMV 

SR2,7 

000160 

0 0 7F. 

0981 

FFF6 



BNE 

ERRMSG 

000161 

0080 

D 38 0 

0000 

X 


LNJ 

SB5,<ZI DREG 

000162 

0082 

F 380 

0067 



LNJ 

■SB7, <CLE ARR 

000163 

0084 

8752 




CL 

s SR? 

000164 

0085 

OF 8 1 

FFCO 



B 

QUERY 

000165 





* 


* 

000166 

0087 

4C 0 8 



DONMES 

LDV 

SR4,1 1 

000167 

0088 

CF44 

0004 



STR 

SR4,SR4.ZIRRNG 

000168 

0O8A 

B820 

0224 



LOR 

SR3,<MSG2.SR2 

000169 

008C 

BF20 

01 A7 



STR 

SR3,<LPBUF2.SR2 

000170 

008E 

?E 0 1 




ADV 

SR? , 1 

000171 

008F 

2D 0 4 




C M V 

SR 2,4 

000172 

0090 

0981 

FFFfe 



BNE 

DONMES 

000173 

0092 

B800 

0? 1 C 



LOR 

SR3,<RELLS 

000174 

0094 

8F20 

01 A7 



STR 

SR3,<LPBUF2.SR2 

000175 

0096 

0380 

0000 

X 


LNJ 

$B5,<ZIORER 

000176 

0098 

0F8 1 

FFC2 



B 

DISCOM 

000177 





* 


* 

000178 

0 0 9 A 

4C0D 



DEVERR 

LDV 

SR4,1 3 

000179 

009B 

CF44 

0004 



STR 

SR4,SR4.ZIRRNG 


GFT CONNECT IORB 

AND connect communications CONSOLE 
CLEAR MESSAGE BUFFER 
GET MESSAGE TEXT 
AND STORE ADDRESS 
ADD 1 TO COUNTER 
8 CHARACTERS? 

IF NOT, GET MORE 
GFT BELLS 

AND STORE IN BUFFER 


PRINT MESSAGE ON KSR 
AND THEN GO TO READ KS 
GET DISCONNECT IORB 
DISCONNECT COMM CONSOLE 

LOAD KSR INPUT IORB 

READ COMMAND 


GET IORB 

GET CONTROL BYTE 

AND STORE ADDRESS 

CLEAR COUNTER 

GET LPBUF2 

SET COUNTER TO 36 

GO CLEAR BUFFER 

CLEAR COUNTER AGAIN 

AND GO BACK WHERE YOU CAME FROM 


GET MESSAGE TEXT 
AND STORE ADDRESS 
ADD 1 TO COUNTER 
14 CHARACTERS? 

IF NOT, GET MORE TEXT 
ELSE,GO PRINT IT 
CLEAR BUFFER AGAIN 


GET MESSAGE TEXT 
AND STORE ADDRESS 
ADD 1 TO COUNTER 
8 CHARACTERS? 

IF NOT, GET MORE TEXT 


GO PRINT MESSAGE 

AND THEN GO DISCONNECT COMM CONSOLE 



:-ll AU49 


?oo 

780*?? 

L 6 

A S S E M R l, E » • 0 ? 0 0 

r 

test QROGRAm 

RAGE 0009 


no 018 0 

0 0 90 

8820 

0228 


|_nR 

*R3,<MSG3.5R? 


000181 

0 0 9 F 

RF 2 0 

01 A7 


STR 

SR3,<LPPUF?.$P2 

STORE ADDRESS OF MESSAGE 

00 01 8? 

n o A l 

?FA 1 



A 0 V 

*B2, 1 

ADD 1 TO COUNTER 

0 0 0 1 8 3 

no a? 

200 6 



CMV 

SR 2,6 

12 CHARACTERS? 

000 )flu 

on A 3 

0981 

F F F 8 


0NF 

OEVEPR IE MOT 

GET MORE TFXT 

000185 

0 0 A s 

0 3 8 0, 

0000 X 


LNJ 

SP5,<ZTOREO 

OTHERWISE# GO PRINT IT 

0 0 0 J 8* 

no A7 

875? 



CL 

= $P? 


000187 

o n A 8 

OF?) 

F F 9 (1 


8 

QUERY 


000188 




★ 


* 


000180 

o n A A 

F 380 

006 7 

TMG1 

LNj 

SR7,<CLFARR 


000100 

OOAC 

OF 8 1 

ffoa 


B 

OOMMFS 


0001 91 

no Af 

F 360 

0067 

T*IG2 

LNJ 

TR7,<CLFARR 


00019? 

0080 

0 F 8 1 

F F C 9 


B 

FRRMSG 


000103 

0 0 82 

F 380 

00*7 

TWIGS 

LNJ 

SR?,<CLE APR 


o o o 1 o n 

0 0 HU 

OFP ) 

FFE5 


B 

OEVERR 


000 1 OS 




* 


■k 


0O0196 




* 

* 

♦ REAP CONSOLE INPUT * * 

000197 




* 


* 


000198 

0088 

8800 

01 A2 

G8TCH 

LOB 

S»3.<KSRBUF 

GET 1ST TWO CHARACTERS 

000)99 

0088 

H 9 0 0 

0 1 F 7 


CMR 

$R3, <TERM 


ooo?oo 

0 0 8 A 

090 1 

FFEF 


BE 

TWIG1 


0 0 0 ? 0 1 

008C 

890 0 

0230 


C MR 

SR3,<CH? 

COMPARE TO CA 

0 0 0 ? 0 ? 

OORF 

098 1 

FFEF 


BNE 

TWIG? 

WRONG COMMAND 

000?03 

OOCO 

8 8 0 0 

01 A3 


LOR 

SP3,<KSRRUFf 1 

GET 2ND TWO CHARACTERS 

000209 

OOC2 

890 0 

0 23F. 


CMR 

$R3# <CH9 

COMPARE TO RD 

0 0 0 ? 0 5 

O0C9 

0981 

FFE 9 


HME 

TWTG2 

WRONG COMMAND 

000206 

0 0C6 

8 8 0 0 

0 1 A9 


LOR 

*R3,<KSPBUF+2 

GET NEXT Two CHARACTERS 

0 0 0 ? 0 7 

OOCP 

H900 

023F 


C MR 

$R3,<CH6 

COMPARE TO IN 

000208 

OOC A 

0981 

FF E 3 


BNF 

TWIG? 

WRONG COMMAND 

0 0 0 20 9 

oocc 

0 F 8 1 

000 1 


B 

CARORD 


000210 




★ 


* 


00021 1 




* 

★ 

* R E A 0 CARPS 


00021 ? 




★ 


* 


0002)3 

OOCF. 

C h 8 0 

00 30 

CARORD 

LAB 

SH9,<CDPIN 

GET I ORB 

ooo?io 

OOPO 

0380 

0000 X 


LNJ 

*B5,<ZI0RFQ 

READ A CARD 

000215 

0002 

0600 

01CF 


LOR 

$R3,<CDRBUF 

LOAD IT IN 

00021 8 

00D9 

0970 

1020 


CMR 

$R3 »= Z ' 1020' 

COMPARE TO EOF 

00021 7 

0 006 

090 1 

0090 


BE 

C0M0U1 

IF EOF, GO TO COMM CONSOLE 

00021 8 

0 0 08 

6752 



CL 

= $R? 


000219 

0009 

8759 



CL 

s SR 9 


000220 

OOOA 

1901 

0003 


REZ 

SRI , CHFCK 

IF NO ERROR, GO TO CHECK 

000221 

oooc 

0 F 8 1 

FF 05 


B 

TWIG3 

OTHERWISE, DEVICE ERROR 

0 0 0222 

0 0 OF 

8 2 A 0 

01CF 

CHECK 

LLH 

SR3,<C0RBUF.SR2 


000223 

OOF 0 

2E01 



A 0 V 

SR2,1 


000229 

OOF 1 

8 1 F 0 

2000 


CVH 

SR3,*Z'20 ' 


000225 

00F3 

098) 

0006 


BNE 

COUNT 


000226 

OOE5 

2050 



CMV 

$R?,80 


000227 

0 0E6 

0901 

0009 


BE 

COVOUT 


000228 

0 0 E 6 

OF 8 1 

FFF5 


B 

CHECK 


000229 

OOE A 

C 852 


COUNT 

LOR 

SRU,s$R? 


000230 

OOEP 

2050 



CMV 

$R2,80 


000231 

OOEC 

0901 

0003 


BE 

COMOUT 


000232 

0 0 EF 

0F81 

FFEF 


B 

CHECK 


000233 




* 


* 


000239 




it 

* 

★send carp input 

TO communications DEVICE* 

000235 




★ 


* 


000236 

OOFO 

CB80 

0028 

COMOUT 

LAB 

SB9 , <COMC0 

GET IORB 

000237 

00 F2 

AB80 

01 A6 


LAB 

SR2 , <LPBUF1 

GET CONTROL BYTE 

000236 

0 0 F 9 

AFC9 

0003 


STB 

$B2,SR«.ZIRBAD 

AND STORE ADDRESS 

000239 

0 0 F6 

9E01 



ADV 

SR9,1 




:-12 AU4 9 


COM200 


760622 


L6 ASSEMBLER-0200 


COMM TEST PROGRAM PAGE 0005 


0002*10 

0087 

CF*ia 

000*4 


STR 

$R*I, SRa.ZIRRNG 


0002*11 

00E9 

8752 



CL 

sSR? 

CLEAR R2 COUNTER TO ZERO 

0002*12 

OOFA 

0820 

01CF 

COMMO 

LOR 

SR3,<CDRBUF.$R2 

GET TWO CHARACTERS FROM CDRBUF 

0002*43 

OOFC 

BF20 

01 A7 


STR 

*R3,<LPBUF2.SR2 

AND STORE IN LPBUF2 

0002*4*4 

OOFE 

2E01 



A 0 V 

SR2,1 

ADD 1 TO COUNTER 

0002*45 

OOFF 

202*1 



CMV 

SR2,36 

COMPARE TO 36 

0002*46 

0100 

0981 

FFF9 


BNE 

COMMO 

IF NOT 36,GET MORE 

0002*47 

0102 

D380 

0000 X 


LNJ 

SB5,<ZI0REQ 

OTHERWISE SENO TO COMM DEVICE 

0002*18 

01 0*1 

1981 

FF AO 


BNE Z 

SRI,TwlG3 


0002*19 

0106 

F3C0 

0003 


LNJ 

SB7,GETIMF 


000250 

0108 

0 F 8 1 

FFC5 


8 

CARORD 


000251 




* 


« 


000252 




★ 

* 

*GET OATE AND TIME 

AND PRINT IT* 

000253 




* 


* 


00025*1 

01 OA 

CB80 

0000 X 

GE T I M F_ 

LAB 

SB*i, <ZXCTOD 

GET DATE AND TIME 

000255 

010C 

8752 



CL 

= SR2 


000256 

0 1 00 

BB80 

022E 


L AR 

SB3, <TIMEP 


000257 

010F 

2C08 



LOV 

SP2,8 


0 0 0258 

0110 

0380 

01 UE 


LNJ 

SR5,<SPACIT 


000259 

0112 

8F6a 



RSTR 

$Ba,=7'lF00 ' 

RESTORE IN R-REGISTERS 3-7 


0113 

1 F 0 0 






000260 

01 1*1 

8F*J0 

0119 


SAVE 

TIMER,=7'1FOO ' 

AND SAVE IN TIMER 


0116 

1 FOO 






000261 

01 17 

1 coa 



LOV 

SRI,=u 

PUT a IN R1 

000262 

0 116 

C 68 0 

022E 


LAB 

SRa,<TI ME R 

GET A DDR OF DATE 

000263 

01 1 A 

1)38 0 

0000 X 


LNJ 

SR5,<zxc MGR 

CONVERT DATF TO ASCII 

0 0 0 26*J 

01 1C 

1C03 



LOV 

SRI,=3 

PUT 3 IN R1 

000265 

0110 

CB8 0 

0000 X 


lab 

SB*1,<7XCT0D 


0 0 02 66 

01 IF 

8F8a 



RSTR 

SRa,=Z'1EO 0 1 



0 1 20 

1 F 0 0 






000267 

0121 

8Fao 

0 1 OF 


SAVE 

TIMFP+3,=Z'1F00' 



0123 

1 F 0 0 






000268 

012a 

C 8 8 0 

0231 


LAB 

SBa,<TIMF'R + 3 

GET ADOR OF TIME 

000269 

0 1 26 

0360 

0000 X 


LNJ 

SB5,<ZXCMGR 

CONVERT TIME TO ASCII 

000270 




* 


* 


000271 

01 26 

Ch«0 

0 0 38 

P R T M1 

LAR 

SB*4, <l.PTOUT 

GET I ORB 

000272 

0 1 2 A 

A R 6 0 

01 A6 


LAB 

SR2,<LPBUF 1 

GET CONTROL RYTF 

000273 

012C 

AF c a 

0 0 0 3 


STR 

SB2 , $B*I . ZIRRAO 

STORE ADDR 

000270 




* 


* 


000275 

01 2E 

8762 


7 IP IT 

CL 

= SR2 

SET R2 TO 0 

000276 

012F 

BP80 

01 A7 


LAB 

SB3,<L PPUF2 

GET LPT BUFFER 

000277 

0 131 

2C20 



L D V 

SR?,=36 

PUT 36 IN R2 

000278 

0 1 32 

0 38 0 

o l ap 


LNJ 

SR5,< SP AC I T 

CLEAR BUFFER TO SPACES 

000279 




★ 


* 


000280 

o 1 3a 

c*ao 

0 1 oc 

PR T m 2 

LOR 

SRa,SLASH 

GET A SLASH 

000281 

0 1 36 

E65« 



LOR 

SR6 , =$R*1 

ONE FOR R6 TOO 

000282 

0137 

660 0 

022E 


LOR 

SR3,< TIMER 

LOAD YEAR IN R3 

000283 

0 1 39 

RFC 0 

OOFS 


RSTR 

TIMEP+1,=Z '0500* 

LOAD REST OF DATE IN R5 AND R7 


0 1 36 

0 50 0 






000280 

01 3C 

8F80 

0 06 A 


SAVE 

LPBUF?,=Z 1 1F 00 1 

AND SAVE R3-P7 INTO LPBUF2 


01 if 

1 F 0 0 






000285 

o 1 3F 

C8aO 

0102 


LOR 

SRO,COLON 

PUT A COLON IN Ra 

000286 

0 l a 1 

F8S4J 



LOR 

SR6,=SPa 

AMD ALSO IN R6 

0002«7 

o l a2 

8FC0 

OOFF 


RSTR 

TTMER+3,=7'7500' 

GET TIME AND PUT IN OTHER R-REGISTERS 


o l a a 

7500 




X 


000268 

o i y 5 

8F a o 

0067 


SAVE 

LPBUF2 + 6 , s Z ' 7F 00 ' 

AND SAVE INTO LPBUF? 


0 1 U 7 

7 F 0 0 






000289 

o i a8 

038 0 

0 0 0 0 X 


LNJ 

sR5,< zIoRF 0 

GO PRINT IT 

0 o 0290 

o l a a 

190 1 

0 008 


BE7 

SRI,PRINT 

IF STATUS OK, GO ON 

000291 

0 i ar 

0 F 8 1 

F F 6 5 


B 

T *103 

OTHERWISE, DFVICF ERROR 



—13 AU49 


COM200 

7 6 0 b 2 2 

L 6 

9SSFRL E9-0200 

c n m 0 

TF ST PROGRAM 

PAGE 00 06 


00029? 





* 


♦ 


000297 


0 19 6 



SPACIT 

EQU 

$ 


000299 

0 1 9 F. 

F P 0 0 

0 29 0 



LOP 

$R6,<planks 


0 0 0295 

0 1 50 

E66H 



09 

S TP 

$R6,$07,-$RP 


000296 

0 151 

2 96 F 


r 


RN'EZ 

$R?,>-$9 


0 0 0?97 

o 1 52 

6 70^ 




JMP 

SH6 


000298 





* 


♦ 


000299 





* 

* 

♦PRINT CARO INPUT 


000300 





* 


♦ 


000301 

0153 

0 6 0 0 

0 0 36 


PRINT 

1.90 

$09 ,<LPTOUT 

GET I OR8 

000302 

0155 

9 0 0 0 

0196 



LAB 

$H2,<LPBUF1 

GET CONTROL BYTE VALUE 

000303 

0157 

AFC 9 

0003 



STP 

$02,$R9.Z IR0AO 

PLACE IT IN RUFFER 

000369 

0 1 59 

075? 


. 


CL 

= $R? 


000305 

0 1 59 

6020 

0 1 CF 


PRINT 1 

LOR 

$R3,<CDPRUF.$R? 

GET 2 CHARACS FROM CDRRUF 

000306 

0 1 5C 

0 F?O 

0 197 



STR 

$R3,<LPBUF2.$R2 

STORE IN LPBUFP 

000307 

015E 

2 6 0 1 




ADV 

$R?, 1 

A OP 1 TO COUNTER 

000306 

0 156 

20 ? 9 




CMV 

$R2,36 

72 CHARACTERS? 

000309 

0 1 60 

0 961 

FFF9 



RNF 

PRINT 1 

IF NOT, GET MORE 

00031 0 

0 1 62 

0 30 0 

0000 

x 


LNJ 

$05,<?TORFO 

PRINT A LINE 

00031 1 

0 1 69 

1901 

F F 9 0 



BNEZ 

$ R1,TWTG3 


00031 ? 

0 1 6b 

0307 




jwp 

$07 


000313 





♦ 


♦ 


000310 





* 

* 

♦COMMUNICATIONS CONSOLE I/O* 

0 0 0 31 5 





* 


♦ 


000316 

0167 

0 0 00 

0197 


roMQui 

L A 0 

$ 0 3, < L P B U F 2 


000317 

0169 

0752 




CL 

= $R? 


000316 

0 1 6* 

2C29 




LOV 

$ R 2,36 


000319 

0160 

D 36 0 

019E 



LNJ 

$B5,<SP9CIT 

CLEAR BUFFER TO SPACES 

000320 

0 160 

C«0O 

0028 



LAP 

$09,<COMCO 

GFT I ORB 

000321 

0166 

9000 

0196 



LAB 

$B2»<LP8UF 1 

GET CONTROL BYTE 

000322 

0171 

9 F C 9 

0003 



STB 

$B?,$B9,?IRBAO 

AND STORE ADDRESS 

000323 

0173 

9C07 




LOV 

$R0,7 


000329 

017 9 

CF'99 

0009 



STR 

$R9,$P«.ZIRRNG 


000325 

0176 

0752 




CL 

= $R2 

CLEAR COUNTER 

000326 

0177 

B02O 

0239 


comitue 

LOR 

$R3,<OUFS2.$R2 


000327 

0 1 79 

PF20 

0197 



STR 

$R3,<LPBUF2.$R? 

STORE MESSAGE IN OUTPUT BUFFER 

000326 

0170 

?E 0 1 




AO V 

$R2,1 

ADD 1 TO COUNTER 

000329 

0 1 7 C 

2003 




CMV 

$R2,3 

6 characters? 

000330 

01 7D 

0981 

FFF9 



BNE 

COMOUE 

IF NOT, READ SOME MORE 

000331 

01 7F 

CRPO 

0028 



LAB 

$B9,<COMCP 


000332 

0161 

0 36 0 

0000 

X 


LNJ 

$R5,<ZIOREO 

OTHERWISE, SEND MESSAGE 

000333 

0163 

1901 

0009 



BEZ 

$R1,COMIN 

IF STATUS OK, GO TO READ INPUT 

000339 

0165 

0 F6 1 

FF2C 



0 

TWIG3 

ELSE, DEVICE ERROR 

000335 

0 167 

0900 

0 1F 7 


ENDIT 

CMR 

SR3,<TFRM 


000336 

0 1 69 

0961 

0009 



flNE 

COMMI 


000337 

016R 

6752 




CL 

s$RP 


000338 

0 1 ec 

0F61 

FE09 



B 

QUERY 


000339 

01 BE 

CH60 

0020 


COM IN 

LAB 

$B9,<COMC I 

GET IORB 

000390 

0190 

0 36 0 

0000 

X 


LNJ 

$R5,<ZI0REQ 

READ COMM CONSOLE INPUT 

000391 

019? 

6752 




CL 

= $R2 

CLEAR COUNTER TO ZERO 

000392 

0193 

0820 

0 1 F 8 


COMMI 

LDR 

$R3,<COMPFR.$R2 

GET TWO CHARACTERS 

000393 

0195 

BF20 

0 1 CF 



STR 

$R3,<CDRBUF.*R2 

AND STORE IN CDRBUF 

000399 

0197 

2E 0 1 




ADV 

$RP, 1 

ADD 1 TO COUNTER 

000395 

0196 

2001 




cvv 

$R2,1 COMPARE 

TO 1 

000396 

0199 

090 1 

FEED 



BE 

ENOIT 

GO CHECK IF THEY ARE TC 

000397 

01 9B 

2029 




CMV 

$R2,36 

72 CHARACTERS? 

000398 

01 9C 

0981 

FFF6 



BNE 

COMMI 

IF not, get more 

000399 

0 1 9E 

F3C0 

FF6B 



LNJ 

$R7,GFT I ME 

ELSE,GO GET THE TIME 

000350 

01 AO 

OF 6 1 

FFEO 



B 

COMIN 

GO READ MORE FROM COMM CONSOLE 

000351 





♦ 


♦ 




-14 AU49 


o 


COM200 

760622 

L 6 4SSF^BtEH“0?00 

CflF^ 

TEST program 

P4GF 0007 

00035? 



•* 

* 

♦DEFINITIONS AND EQUATES 

000353 



* 


* 

0 0 o 35 4 

ot a 2 


ksrbuf 

»FSV 

4 

000355 

0 1 46 

204 1 

lprufi 

TEXT 

* A ' 

000356 

0 1 4 7 


LPBUF? 

RFSV 

40 

0 0 o 3 5 7 

01 CF 


CORBUF 

RES V 

40 

000358 

0 1 F 7 

5443 

TFRM 

TFXT 

' TC ' 

000359 

0 1 F 8 


CO M BF P 

PESO 

36 

000360 

021 C 

0707 

BFLLS 

TEXT 

Z'07O7' 

000361 

0210 

434F 

MSR1 

TEXT 

•COMMAND FRRORI' 


021 E arjur 
021F ai«F 
0220 4420 

02?1 4552 

0??? 524F 

0223 5221 


0 0 0 362 

0224 

4 1 4 C 

MSG2 

TEXT 

' ALL DONE' 


o ??5 

4C20 





0226 

4 4 4 F 





0227 

4E45 




000363 

022 s 

4445 

MSG3 

TFXT 

•DFVICF EPROP 


0229 5649 

o??fi 4345 
022P 2045 

022C 5252 

0220 4F52 


000364 

022E 


TIMER 

RESV 

8 

000365 

0236 

434F 

QUES 

TEXT 

t COMMAS 


0237 

40 4 n 





0238 

4 1 4 F 





0239 

4434 




000366 

o?34 

4 9 4 E 

Ql'F.S? 

TEXT 

•INPUTS • 


023H 

5055 





023C 

5434 




0OQ367 

0230 

434 1 

CH2 

TEXT 

•CA ' 

00036P 

023F 

5244 

CH4 

TEXT 

• RD ' 

000369 

023F 

4 9 4 E 

CH6 

TEXT 

•IN' 

000370 

0240 

2020 

BLANKS 

DC 

X'2020 • 

000371 

0241 

2F20 

SLASH 

TEXT 

'/ • 

000372 

0242 

3420 

COLON 

TEXT 

•: 1 

000373 



* 


* 

000374 



★ 


* 

000375 



* 


* 

000376 

0243 

0 F 0 1 F F F 9 

FINIS 

NOP 

CH? 

000377 

0?4S 

0 00 0 


h L T 


000378 

0246 



ENO 

COM200 

0000 ERR COUNT 







INDEX 


ACTION 

CLM ACTION DURING LOADING, 3-13 
ELACT COMMAND (END LOAD COMMAND), 
A-13 

LACT COMMAND (LOAD ACTION), A-17 
ACTIVATE 
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